跳转到主要内容
POST
/
mxn
/
collect
/
apply
curl --request POST \
  --url https://uat-interface.haipay.asia/mxn/collect/apply \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "20.00",
  "callBackFailUrl": "https://www.example.com/failed",
  "payType": "QR",
  "callBackUrl": "https://www.example.com/success",
  "inBankCode": "CASH",
  "orderId": "SINGLE_1763358741905",
  "phone": "1234567890",
  "appId": "4755",
  "name": "TEST NAME",
  "partnerUserId": "dfff@fg43123",
  "sign": "Si8+iTS7zZ4oX1bMCZ9PPFoJwgw9mGEwMc1UIADOrbs7xlCL+f5e+OYcvhKa4HXCxybqu6MTft6t6Smy9gvu8bPw/erwHdKbP/QzRDU5qHfMj9+1IZzZvJQJR/i5/TW9Y+L4xkOOsaTXfEYuDsZTjyNqy/si5EbUgl1CzVMuH3BORpB7H2f0P34RHqt8t5SZet7YfZLs+dcriczmqHAKhILHgIc7VHSfiAna00J2KjM93qO6kXa8LIjw7FVbX5f6ZMOUjrl13M3DDx01qSW0JVCSxRqEN9yTYTPMV8eFCSk+Picr78/vyMEKnRjnccUx4OZy1cK/9rIfi538xTEAbQ==",
  "email": "test.single@example.com"
}
'
{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "orderId": "SINGLE_1763358111905",
    "orderNo": "2025111713522220822",
    "payUrl": "https://www.paycashglobal.com/formato.php?referencia=MTQ3MTMyNDEwMjQzNQ==&interno=1",
    "bankCode": "CASH",
    "qrCode": "1471324102431",
    "sign": "mpcB0wfbvGpCSNbT8Gs+D4Tt1eMDqTgnuY6yVUAdemccC07nnWrxSPk4srHFXeoXpdWm+CKFh89rghU16kZq2pm9dw0jSlns0dj5c7sDO8Te0KMNGfleuQ+N/16sGZr/LE7MAWj6Z902ymiff6q+N1ljTfIDypHTztbGDpJvemZ9OkB2BCemsoAX6ukkXyZJPI+gkyJEDCPfOcWfXeNmdWOKxyXLOJEjIBno2oyZoDs3yJqkMtCyQW1cjgTTOQbnxgCjHV9YQ+OcLVdkFroC/HrP8p9c8qRICDX/NMEt4Z0Zo1eBV07rkebuY60+A1kSuD7axO0UxSq6BbXKjgNqyQ=="
  }
}

密钥私钥(生成签名)

请求体

application/json
appId
integer
必填

业务ID(后台获取,需要根据URL中的币种传递对应的业务ID)

orderId
string
必填

商户订单号(必须保证唯一性,长度不超过48)

Maximum string length: 48
name
string
必填

收款人姓名(收款人姓名格式:英文大小写且允许有空格,1-30位,"firstName middleName lastName" (middleName非必填,特殊字符支持'.-)

Required string length: 1 - 30
Pattern: ^[A-Za-z\s'.\-]+$
phone
string
必填

真实手机号(格式参考 电话号码格式 )

email
string<email>
必填

真实电子邮件

amount
string
必填

交易金额(单位:Mex$,精确到小数点后两位;禁止添加标点符号,例如:",")

Pattern: ^\d+\.\d{2}$
payType
enum<string>
必填

用户支付方式:QR(条形码支付)或 VA(虚拟账户)

可用选项:
QR,
VA
inBankCode
string
必填

收款编码,当payType为QR时,inBankCode支持:OXXO、CASH 支付方式;当payType为VA时,inBankCode为CLABE

callBackUrl
string<uri>
必填

用户支付成功后跳转地址

callBackFailUrl
string<uri>
必填

用户支付失败后跳转地址

partnerUserId
string
必填

用户唯一标识(如用户ID userId),用于风控系统,必须真实有效,否则会影响交易。 格式要求:数字、大小写字母或常用符号-~!@#$%&*()_。

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
必填

签名

notifyUrl
string<uri>

回调地址

subject
string

支付备注

body
string

备注详情

响应

200 - application/json
status
string
error
string
msg
string
data
object
Last modified on April 10, 2026