# 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”,后续通过查询/回调更新状态