# 1. 代付下单接口

# 简要描述

  • 商户代付-下单接口

# 请求URL

  • {domain}/open-api/philippines/disbursement/transfer

# 请求方式

  • POST

# 请求头

参数名 必选 类型 说明
Content-Type mandatory string application/json

# 请求体参数

参数名 必选 类型 长度限制 示例 说明
appId string - - 应用APPID
param string - - 参数体
sign string - 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 签名

# param 参数

参数名 必选 类型 长度限制 示例 说明
timestamp long - 1678356680000 毫秒时间戳
mchOrderId string 10-32 CCP20220428011068111 商户订单id,格式:字母+数字, 1-32位
idempotencyId string 10-32 幂等式校验KEY, 格式:字母+数字,10-32位
amount long - 50000 代付金额(单位为分) 例如PHP:500.10, 需要设置50010分
accountNo string 1-50 - 收款人账号(如果是是电子钱包,应为09开头手机号格式)
accountName string 1-128 - 收款人姓名 格式:英文大小写且允许有空格,1-30位,"firstName middleName lastName" (middleName 非必填, 特殊字符支持 '.-)
payMethodCode string - 参考此列表 代付类型
transferCode string - 参考此列表 收款渠道编码
remark string 1-256 - 代付备注

# 请求示例

# 请求体

{
  "appId": "349094b672f3479692ca70790477a8af",
  "sign": "LvSt/yg0XBwWkpNMD+2i43Zr0Ku7QCj6GWWKJWvuMuCH9xO4KUijPkzdO9lrLw7m7Ji6CHwln/0Oof6Au1rocnMQoxv/SDebIlnJlq2Rc9csZ8NbT0Ymgc67BPB8z3dXVCO6QCCpf0O0fVDHZ+sCpLiZTyd2+xUfUrFQaulq5/Gqa0m+uKyV5CF1kfLav0ppOcd80tEX21zzxiDormmtt//LhIBvN43DyqEqTXWUB7E7DFCctTUrJ6LRxOZrKPxMsXGZUod2zhWnD1LsdNbFm2SUhTDzURACSgdRVg2GstJoy2eA/5ODv8VXj+WL6tVR57pzo922Btlse2T3p08MBQ==",
  "param": "{\"mchOrderId\":\"8af3859431540122100\",\"idempotencyId\":\"8af3859431540122100\",\"amount\":3000,\"accountNo\":\"109594480004\",\"accountName\":\"Gun ChunCheng\",\"payMethodCode\":\"BANK\",\"transferCode\":\"UBP\",\"timestamp\":1683859432}"
}

如何构造请求体


# 响应参数

参数名 类型 说明
code integer 响应码
message string 响应信息
data Object 数据

# data参数

参数名 类型 示例 说明
mchOrderId String - 商户订单号
transactionId String D1656505190221611009 Platform系统订单号,Platform系统唯一标识
transactionStatus String 参考列表 交易状态
transactionTime String 2023-05-04 11:43:08 交易创建时间

# 响应示例

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "8af3794867690754100",
    "transactionId": "D1656581872743874560",
    "transactionStatus": "PENDING",
    "transactionTime": "2023-05-04 16:47:50"
  }
}

响应码集合

# 失败响应示例

{
  "code": 21000,
  "message": "Server error, Please try again later.",
  "data": null
}