Skip to main content
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=="
  }
}

Secret Key & Private Key (Generate Signature)

Body

application/json
appId
integer
required

Business ID (obtained from the backend, must correspond to the currency in the URL)

orderId
string
required

Merchant Order Number

Maximum string length: 48
name
string
required

Payer's Name (format: English letters, spaces allowed, 1–30 characters, "firstName middleName lastName"; middleName optional; special characters allowed: '.-)

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

Valid phone number

email
string<email>
required

Valid email address

amount
string
required

Transaction Amount (unit: Mex$, precise to two decimal places; do not use punctuation such as ",")

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

Payment Method: QR (Barcode Payment) or VA (Virtual Account)

Available options:
QR,
VA
inBankCode
string
required

Collection Code. When payType is QR, inBankCode supports: OXXO, CASH payment methods; when payType is VA, inBankCode is CLABE

callBackUrl
string<uri>
required

Redirect URL after successful payment

callBackFailUrl
string<uri>
required

Redirect URL after failed payment

partnerUserId
string
required

Unique User Identifier (e.g., userId), used for risk control. Must be valid; otherwise, the transaction may be affected. Allowed format: numbers, letters, or common symbols -~!@#$%&*()_.

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

Signature

notifyUrl
string<uri>

Callback URL

subject
string

Payment Note (transaction title, product name, payment reason)

body
string

Additional Details

Response

200 - application/json
status
string

1: Normal, 0: Exception

error
string

Error code

msg
string

Error description

data
object
Last modified on April 10, 2026