This section provides reference data and enumerations used in the payment workflow, including test cards, order types, order statuses, dispute information and error code reference.
The following test card numbers can be used in the sandbox environment for payment testing.
| Card type | Test card number |
|---|
| Maestro | 6759649826438453 |
| Mastercard | 5555555555554444 5454545454545454 2221000000000009 |
| Mastercard Debit | 5163613613613613 |
| Visa | 4444333322221111 4911830000000 4917610000000000 |
| Visa Debit | 4462030000000000 4917610000000000003 |
The following order types are used to identify the purpose of each transaction.
| Enum Value | Description |
|---|
PAYMENT | Normal payment order (customer pays merchant for goods/services) |
REFUND | Refund order (merchant refunds the customer for a previously paid order) |
The following order statuses indicate the current state of a payment or refund during its lifecycle.
| Enum Value | Description |
|---|
PENDING | Order created, being processed (initial status) |
READY | Order processed successfully, waiting for customer payment |
PAID | Customer has paid successfully, order completed |
FAILED | Order processing failed (e.g., gateway error, parameter error) |
CANCELED | Order canceled (initiated by the merchant or customer via the cancel interface) |
REFUNDED | Order has been fully refunded |
CANCELING | Order cancellation is in progress (intermediate status) |
AUTHORIZED | Payment has been authorized (for pre-authorization scenarios) |
REFUNDING | Refund is in progress (intermediate status) |
CAPTURED | Authorized amount has been captured (for pre-authorization capture scenarios) |
CLOSED | Order closed (usually due to expiration without payment) |
The following dispute case types classify different stages and categories of dispute or chargeback events.
| Enum Value | Description |
|---|
FIRST_CHARGEBACK | Initial chargeback initiated by the issuing bank on behalf of the cardholder (the first formal dispute for a transaction). |
SECOND_CHARGEBACK | Secondary chargeback raised by the issuing bank if the merchant successfully overturns the first chargeback (requires new evidence from the issuing bank). |
RAPID_DISPUTE_RESOLUTION | Fast-track dispute process (RDR) - Used for low-value or clear-cut disputes to resolve issues quickly without formal chargeback procedures. |
RETRIEVAL | Request from the issuing bank to retrieve transaction documentation (e.g., receipts, order confirmations) - May precede a formal chargeback if documentation is insufficient. |
The following dispute case statuses describe the current progress of a dispute throughout its resolution process.
| Enum Value | Description | Merchant Action Required |
|---|
NOTICE | Dispute notification sent to the merchant (case has been opened). | Yes - Review dispute details, prepare evidence, and submit before dueDate. |
REPRESENTATION | The merchant has submitted evidence; the case is pending review. | No - Wait for the issuing bank/card network to issue a ruling. |
ISSUER_PENDING | The case is under review by the issuing bank. | No - No action required until a ruling is made. |
CB_DISPUTE_WIN | The merchant has won the dispute; funds will be returned. | No - Confirm fund receipt (system will process automatically). |
CB_DISPUTE_LOSS | Merchant has lost the dispute; funds will be deducted. | No - Review the ruling and adjust internal processes if needed. |
AGREE_CB | The merchant has agreed to the dispute (no evidence submitted). | No - Case will be closed as "lost" automatically. |
CANCEL | Dispute has been canceled (e.g., initiated in error). | No - No further action required. |
CLOSED | Dispute process is fully completed (final status). | No - Case is archived; no additional updates. |
The following error codes describe errors that may occur during payment processing and related operations.
| Type | Code | Message | HTTP Status |
|---|
| General | 150001 | Unable to process the request | 400 BAD_REQUEST |
| Type | Code | Message | HTTP Status |
|---|
| Request Parameters | 151001 | Invalid request parameters | 400 BAD_REQUEST |
| Request Parameters | 151002 | The payment method is required in direct mode | 400 BAD_REQUEST |
| Request Parameters | 151003 | Country is required | 400 BAD_REQUEST |
| Request Parameters | 151004 | State or province is required | 400 BAD_REQUEST |
| Request Parameters | 151008 | Success and failure URLs are required for redirect payments | 400 BAD_REQUEST |
| Request Parameters | 151009 | Invalid URL | 400 BAD_REQUEST |
| Request Parameters | 151010 | Amount for %s must have at most %d decimal places | 400 BAD_REQUEST |
| Type | Code | Message | HTTP Status |
|---|
| Card Information | 151101 | Card information is required | 400 BAD_REQUEST |
| Card Information | 151102 | Invalid card number | 400 BAD_REQUEST |
| Card Information | 151103 | Invalid card expiration date | 400 BAD_REQUEST |
| Type | Code | Message | HTTP Status |
|---|
| Merchant Configuration | 153101 | This payment method is not enabled for your account | 400 BAD_REQUEST |
| Merchant Configuration | 153102 | No payment methods are enabled for your account | 400 BAD_REQUEST |
| Merchant Configuration | 153103 | Direct payments are not enabled for your account | 400 BAD_REQUEST |
| Merchant Configuration | 153104 | Redirect payments are not enabled for your account | 400 BAD_REQUEST |
| Merchant Configuration | 153105 | No matching payment configuration was found | 400 BAD_REQUEST |
| Merchant Configuration | 153106 | Payment method %s does not support transaction type %s | 400 BAD_REQUEST |
| Merchant Configuration | 153107 | Transaction type %s is not enabled for your account | 400 BAD_REQUEST |
| Merchant Configuration | 153108 | Currency %s is not supported by your account | 400 BAD_REQUEST |
| Type | Code | Message | HTTP Status |
|---|
| Payment Service | 154001 | Payment service is temporarily unavailable | 503 SERVICE_UNAVAILABLE |
| Payment Service | 154002 | Payment service is temporarily unavailable | 503 SERVICE_UNAVAILABLE |
| Payment Service | 154003 | This payment method is not supported | 503 SERVICE_UNAVAILABLE |
| Type | Code | Message | HTTP Status |
|---|
| Order | 155001 | Order not found | 400 BAD_REQUEST |
| Order | 155003 | Order has expired | 400 BAD_REQUEST |
| Order | 155004 | Payment not found | 400 BAD_REQUEST |
| Order | 155005 | Merchant order number %s already exists | 400 BAD_REQUEST |
| Order | 155006 | Merchant customer ID is required | 400 BAD_REQUEST |
| Order | 155007 | Transfer reference is required for an AFT transaction | 400 BAD_REQUEST |
| Order | 155008 | Unable to create the payment address | 400 BAD_REQUEST |
| Type | Code | Message | HTTP Status |
|---|
| Payment Result | 155101 | Payment declined | 400 BAD_REQUEST |
| Payment Result | 155102 | Insufficient funds | 400 BAD_REQUEST |
| Payment Result | 155103 | Limit exceeded | 400 BAD_REQUEST |
| Payment Result | 155104 | Transaction not permitted | 400 BAD_REQUEST |
| Payment Result | 155105 | Authentication required | 400 BAD_REQUEST |
| Payment Result | 155106 | Authentication failed | 400 BAD_REQUEST |
| Payment Result | 155107 | Verification failed | 400 BAD_REQUEST |
| Payment Result | 155108 | Expired payment method | 400 BAD_REQUEST |
| Payment Result | 155109 | Invalid or unavailable account | 400 BAD_REQUEST |
| Payment Result | 155110 | Lost or stolen card | 400 BAD_REQUEST |
| Payment Result | 155111 | Security violation | 400 BAD_REQUEST |
| Payment Result | 155112 | Unable to authorise | 400 BAD_REQUEST |
| Payment Result | 155113 | Payment not supported | 400 BAD_REQUEST |
| Payment Result | 155114 | Policy reasons | 400 BAD_REQUEST |
| Payment Result | 155115 | Invalid security code | 400 BAD_REQUEST |
| Payment Result | 155116 | Invalid PIN | 400 BAD_REQUEST |
| Payment Result | 155117 | Allowable number of PIN tries exceeded | 400 BAD_REQUEST |
| Payment Result | 155118 | Closed account | 400 BAD_REQUEST |
| Payment Result | 155119 | Do not honour | 400 BAD_REQUEST |
| Type | Code | Message | HTTP Status |
|---|
| Refund Result | 155201 | Refund amount exceeds the original payment amount | 400 BAD_REQUEST |
| Refund Result | 155202 | Total refund amount exceeds the original payment amount | 400 BAD_REQUEST |
| Refund Result | 155203 | Another refund is already being processed for this payment | 400 BAD_REQUEST |
| Refund Result | 155204 | The original payment is not completed | 400 BAD_REQUEST |
| Refund Result | 155205 | Original payment not found | 400 BAD_REQUEST |
| Refund Result | 155206 | The payment has an active dispute and cannot be refunded | 400 BAD_REQUEST |
| Refund Result | 155207 | Insufficient available balance | 400 BAD_REQUEST |
| Refund Result | 155208 | The payment has already been fully refunded | 400 BAD_REQUEST |
| Refund Result | 155209 | Refund failed | 400 BAD_REQUEST |
| Type | Code | Message | HTTP Status |
|---|
| Risk Control | 156001 | Transaction declined | 400 BAD_REQUEST |
| Risk Control | 156002 | This card cannot be used | 400 BAD_REQUEST |
