# 2、创建代付
用于商户发起 PIX 代付请求,系统将执行向收款方账户的转账。
请求方式
- Method:
POST
- 请求 URL
/api/v3/mex/createTransferOrder
请求头 Header
Content-Type: application/json; charset=utf-8
请求头参数说明
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
access_key | String | 商户后台获取的访问密钥 | pFqV75X3 |
timestamp | int64 | 13 位毫秒时间戳 | 1679724896223 |
nonce | String | UUID V4 随机字符串 | 794c26b0-d33c-4394-b2bb-c485eca16d9e |
sign | String | 计算生成的签名值 | kAXyh+eerqrefyaF8dyFB0M4FVo= |
所有参数需放入 Header 中发送,签名生成请参考数据签名规范。
请求示例:
{
"currencyAmount": "40.11",
"channelType": "BANK",
"externalOrderId": "20250604152811292579",
"accountName": "AN GENGYU",
"accountId": "646180000030056845",
"bankName": "BANXICO",
"accountType": "CLABE",
"certificatesId": "646180000030056845",
"notifyUrl": "https://tofficeapi.io/api/v1/api/test/testNotifySuccess"
}
请求参数说明
建议:为提升代付处理效率,以下字段建议全部传入。
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
currencyAmount | String | 是 | 代付金额,保留小数点后不超过 2 位 |
channelType | String | 是 | 支付类型,枚举值:BANK |
externalOrderId | String | 是 | 商户订单号 |
accountName | String | 是 | 银行账号姓名 |
accountId | String | 是 | 收款账号 CLABE类型收款账户为18位 BANK_CARD类型收款账户为16位 |
bankName | String | 是 | 银行名字 |
accountType | String | 是 | 银行账号类型 CLABE BANK_CARD |
notifyUrl | String | 否 | 支付完成后回调地址(服务端) |
remark | String | 否 | 商户自定义备注信息 |
certificatesId | String | 是 | 证件号 |
响应示例
响应 Header 类型
Content-Type: application/json; charset=utf-8
响应数据(成功)
{
"code": "200",
"success": true,
"msg": "成功",
"msgEn": "SUCCESS",
"data": {
"orderId": "OCURRDRAW202506040728131749022093339HAMBIT-U0000000201299923",
"orderStatus": "Accepted",
"externalOrderId": "20250604152811292579",
"currencyType": "MXN"
}
}
响应字段说明
Param | Type | Desc |
---|---|---|
currencyType | String | 法币类型 |
externalOrderId | String | 商户订单 id |
orderId | String | 系统订单 ID |
orderStatus | String | 订单状态,正常返回“Accept”,后续通过查询/回调更新状态 |