Use these test amounts in the sandbox (UAT) environment to simulate specific transaction outcomes when integrating Card Present payments in Mexico.
How it works#
To trigger a specific scenario, send the corresponding MXN amount as the total of the amount object (subtotal_iva0 for untaxed transactions). The sum of all values within the amount object determines which scenario fires.{
"amount": {
"currency": "MXN",
"iva": 0,
"subtotal_iva": 0,
"subtotal_iva0": 5,
"tip": 0,
"extra_taxes": {
"airport_tax": 0,
"iac": 0,
"ice": 0,
"travel_agency": 0
}
}
}
For the example above (total = 5.00 MXN), you will receive:{
"kushki_response": {
"code": "05",
"message": "Do not honor"
},
"transaction_status": "DECLINED",
"transaction_reference": "0c598cc7-bfd5-4180-8544-34a4f923086e"
}
The test response is visible in the kushki_response field of the API response.
Mexico test amounts#
| Amount (MXN) | Response Code | Description |
|---|
1 | 01 | Transaction declined — cardholder must contact their card issuer. |
3 | 03 | Invalid merchant. |
4 | 04 | Card has been reported (captured). Cardholder should use a different card. |
5 | 05 | Do not honor — an error occurred while processing the transaction. |
7.40 | 00 | Approved with delay — transaction approved after a delay (simulates slow processor response). |
17.40 | 00 | Approved with delay — use for void/reversal tests. |
| Any other amount | 00 | Approved — standard approval response. |
MSI testing (Meses Sin Intereses)#
To test MSI scenarios, use any approved amount (not in the error table above) that meets the minimum MSI requirement and include the deferred object:{
"amount": {
"currency": "MXN",
"subtotal_iva": 0,
"subtotal_iva0": 600,
"iva": 0
},
"is_deferred": true,
"deferred": {
"months": "6",
"credit_type": "03",
"graceMonths": "00"
}
}
Minimum amounts for MSI testing: 3 months → 600 MXN, 9 months → 1,200 MXN, 18 months → $1,800 MXN.
Void / Reversal testing#
Use amount 17.40 MXN to test void and reversal flows with a delayed approval response.{
"transaction_type": "charge",
"transaction_mode": "Void",
"amount": {
"currency": "MXN",
"subtotal_iva": 0,
"subtotal_iva0": 17.40,
"iva": 0
},
"transaction_reference": "<reference-from-original-charge>"
}
Environments#
https://api-uat.kushkipagos.com/
Use this environment for all sandbox testing. Your Private-Merchant-Id credentials for UAT are different from production.
Got a suggestion on this documentation? Contact us.