1、创建收款

用于商户发起收款请求，返回支付链接或二维码，供用户完成支付。

请求方式

• Method：POST
• URL：/api/v3/mex/bankTransfers/createCollectingOrder
• Content-Type：

Content-Type: application/json; charset=utf-8

请求头参数（Header）

Param	Type	Description	Sample
access_key	String	商户后台获取的访问密钥	pFqV75X3
timestamp	int64	Unix 毫秒时间戳（13 位）	1679724896223
nonce	String	UUID V4 随机字符串	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	通过签名算法计算的签名	kAXyh+eerqrefyaF8dyFB0M4FVo=

上述参数全部作为 HTTP Header 传入

请求体数据示例

{
	"amount": "40.20",
	"channelType": "CASH",
	"externalOrderId": "354997490558818072",
	"notifyUrl": "http://192.168.1.135:30001/",
	"remark": "123",
	"returnUrl": "http://192.168.1.135:30001",
    "dynamicAmountNotify":1
}

参数说明：

参数名	类型	是否必填	描述
amount	String	是	收款金额，小数点不能超过2位
channelType	String	是	支付类型CASH PAYCASHRECURRENT QRIS
externalOrderId	String	是	商户系统中的唯一订单编号
dynamicAmountNotify	Int64	否	是否开启动态金额回调，1-开启，2-关闭 默认1
notifyUrl	String	是	支付完成后回调地址（服务端）
remark	String	否	商户自定义备注信息
returnUrl	String	否	用户支付成功后跳转地址（前端）

响应类型：

Header: { 'Content-Type': 'application/json;charset=utf-8'}

创建收款响应说明：

正常响应数据示例（HTTP 200）

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": {
		"cashierUrl": "https://cashier-fiat.io/OCURRPAID202506040723051749021785698HAMBIT-U0000000201299921?data=JTdCJTIyY2FzaGllckN1cnJlbmN5QW1vdW50JTIyJTNBNS4wMTAlMkMlMjJjYXNoaWVyRXhwaXJlVGltZSUyMiUzQTE3NDkwMjM1ODU3MTAlMkMlMjJjYXNoaWVySWQlMjIlM0ElMjJPQ1VSUlBBSUQyMDI1MDYwNDA3MjMwNTE3NDkwMjE3ODU2OThIQU1CSVQtVTAwMDAwMDAyMDEyOTk5MjElMjIlMkMlMjJjYXNoaWVyVXJsJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZjYXNoaWVyLWZpYXQuaGFtYml0LmlvJTJGT0NVUlJQQUlEMjAyNTA2MDQwNzIzMDUxNzQ5MDIxNzg1Njk4SEFNQklULVUwMDAwMDAwMjAxMjk5OTIxJTIyJTJDJTIyY3VycmVuY3klMjIlM0ElMjJNWE4lMjIlMkMlMjJjdXJyZW5jeU9yZGVyVm8lMjIlM0ElN0IlMjJhbW91bnQlMjIlM0E1LjAxMCUyQyUyMmNoYW5uZWxCYW5rQWNjb3VudE51bWJlciUyMiUzQW51bGwlMkMlMjJjaGFubmVsQmFua0FjY291bnRUeXBlJTIyJTNBbnVsbCUyQyUyMmNoYW5uZWxCYW5rQ29kZSUyMiUzQW51bGwlMkMlMjJjaGFubmVsQmFua05hbWUlMjIlM0FudWxsJTJDJTIyY2hhbm5lbElkJTIyJTNBMTg0NzEwNjc0MjMyNDA4ODgzNCUyQyUyMmN1cnJlbmN5JTIyJTNBJTIyTVhOJTIyJTJDJTIyZXh0ZXJuYWxPcmRlcklkJTIyJTNBJTIyMjAyNTA2MDQxNTIzMDQ4MTE5MDAlMjIlMkMlMjJtZXJjaGFudEF2YXRhciUyMiUzQSUyMmh0dHBzJTNBJTJGJTJGc3RhdGljLmhhbWJpdC5pbyUyRnVwbG9hZCUyRjIwMjUlMkYwNSUyRmM4MDk2ZDNlLTc5MDQtNGI3Ny04NzE3LTVkMGFjNmVkOWM1Zi5wbmclMjIlMkMlMjJtZXJjaGFudE5hbWUlMjIlM0ElMjJ5dXJpMDA2JTIyJTJDJTIyb3JkZXJBY3R1YWxBbW91bnQlMjIlM0EwJTJDJTIyb3JkZXJJZCUyMiUzQSUyMk9DVVJSUEFJRDIwMjUwNjA0MDcyMzA1MTc0OTAyMTc4NTc1OUhBTUJJVC1VMDAwMDAwMDQwMTI5OTkyMiUyMiUyQyUyMm9yZGVyU3RhdHVzJTIyJTNBJTIyQXdhaXRpbmcrUGF5bWVudCUyMiUyQyUyMm9yZGVyU3RhdHVzQ29kZSUyMiUzQTElMkMlMjJvcmRlclRpbWUlMjIlM0ExNzQ5MDIxNzg1NzQ1JTJDJTIycGF5UGFyYW0lMjIlM0ElMjJodHRwcyUzQSUyRiUyRnd3dy5wYXljYXNoZ2xvYmFsLmNvbSUyRmZvcm1hdG8ucGhwJTNGcmVmZXJlbmNpYSUzRE1UUXlNRGt3TWpFM09EY3hNdyUzRCUzRCUyNmludGVybm8lM0QxJTIyJTJDJTIycGF5VHlwZSUyMiUzQTExMSUyQyUyMnBheVR5cGVOYW1lJTIyJTNBJTIyQ2FzaCUyMiUyQyUyMnBheVVybCUyMiUzQSUyMmh0dHBzJTNBJTJGJTJGd3d3LnBheWNhc2hnbG9iYWwuY29tJTJGZm9ybWF0by5waHAlM0ZyZWZlcmVuY2lhJTNETVRReU1Ea3dNakUzT0RjeE13JTNEJTNEJTI2aW50ZXJubyUzRDElMjIlMkMlMjJwYXltZW50Vm91Y2hlciUyMiUzQW51bGwlMkMlMjJyZXR1cm5VcmwlMjIlM0FudWxsJTJDJTIydHJhZGVOb3RlJTIyJTNBJTIyd3N4MTIzMTIlMjIlMkMlMjJ1c2VySW5mb05vJTIyJTNBbnVsbCU3RCUyQyUyMmlzQ3JlYXRlT3JkZXIlMjIlM0F0cnVlJTJDJTIyaXNIaWRkZW5NZXJjaGFudExvZ28lMjIlM0FudWxsJTJDJTIyaXNIaWRkZW5NZXJjaGFudE5hbWUlMjIlM0FudWxsJTJDJTIybWVyY2hhbnRBdmF0YXIlMjIlM0FudWxsJTJDJTIybWVyY2hhbnRJZCUyMiUzQTE3ODU5NDU4MTE5NzYxOTYwOTclMkMlMjJtZXJjaGFudE5hbWUlMjIlM0FudWxsJTJDJTIycGF5VHlwZSUyMiUzQTExMSUyQyUyMnJldHVyblVybCUyMiUzQW51bGwlMkMlMjJ1c2VySW5mb05hbWUlMjIlM0FudWxsJTJDJTIydXNlckluZm9ObyUyMiUzQW51bGwlMkMlMjJ1c2VySW5mb1R5cGUlMjIlM0FudWxsJTJDJTIydmVyc2lvbiUyMiUzQSUyMnYxJTIyJTdE",
		"currency": "MXN",
		"currencyOrderVo": {
			"orderId": "OCURRPAID202506040723051749021785759U0000000401299922",
			"externalOrderId": "20250604152304811900",
			"currency": "MXN",
			"amount": "5.01",
			"tradeNote": "wsx12312"
		}
	}
}

响应参数说明

参数名	类型	描述
cashierUrl	String	收银台链接
currency	String	币种编码
amount	String	收款金额
externalOrderId	String	商户订单号
orderId	String	系统订单ID
tradeNote	String	备注