Resources

This section provides reference data and enumerations used in the payment workflow, including test cards, order types, order statuses, and dispute information.


1. Test Card

The following test card numbers can be used in the sandbox environment for payment testing.

Card typeTest card number
Maestro6759649826438453
Mastercard5555555555554444 5454545454545454 2221000000000009
Mastercard Debit5163613613613613
Visa4444333322221111 4911830000000 4917610000000000
Visa Debit4462030000000000 4917610000000000003


2. Order Type

The following order types are used to identify the purpose of each transaction.

Enum ValueDescription
PAYMENTNormal payment order (customer pays merchant for goods/services)
REFUNDRefund order (merchant refunds the customer for a previously paid order)


3. Order Status

The following order statuses indicate the current state of a payment or refund during its lifecycle.

Enum ValueDescription
PENDINGOrder created, being processed (initial status)
READYOrder processed successfully, waiting for customer payment
PAIDCustomer has paid successfully, order completed
FAILEDOrder processing failed (e.g., gateway error, parameter error)
CANCELEDOrder canceled (initiated by the merchant or customer via the cancel interface)
REFUNDEDOrder has been fully refunded
CANCELINGOrder cancellation is in progress (intermediate status)
AUTHORIZEDPayment has been authorized (for pre-authorization scenarios)
REFUNDINGRefund is in progress (intermediate status)
CAPTUREDAuthorized amount has been captured (for pre-authorization capture scenarios)
CLOSEDOrder closed (usually due to expiration without payment)


4. Dispute Case Type

The following dispute case types classify different stages and categories of dispute or chargeback events.

Enum ValueDescription
FIRST_CHARGEBACKInitial chargeback initiated by the issuing bank on behalf of the cardholder (the first formal dispute for a transaction).
SECOND_CHARGEBACKSecondary chargeback raised by the issuing bank if the merchant successfully overturns the first chargeback (requires new evidence from the issuing bank).
RAPID_DISPUTE_RESOLUTIONFast-track dispute process (RDR) - Used for low-value or clear-cut disputes to resolve issues quickly without formal chargeback procedures.
RETRIEVALRequest from the issuing bank to retrieve transaction documentation (e.g., receipts, order confirmations) - May precede a formal chargeback if documentation is insufficient.


5. Dispute Case Status

The following dispute case statuses describe the current progress of a dispute throughout its resolution process.

Enum ValueDescriptionMerchant Action Required
NOTICEDispute notification sent to the merchant (case has been opened).Yes - Review dispute details, prepare evidence, and submit before dueDate.
REPRESENTATIONThe merchant has submitted evidence; the case is pending review.No - Wait for the issuing bank/card network to issue a ruling.
ISSUER_PENDINGThe case is under review by the issuing bank.No - No action required until a ruling is made.
CB_DISPUTE_WINThe merchant has won the dispute; funds will be returned.No - Confirm fund receipt (system will process automatically).
CB_DISPUTE_LOSSMerchant has lost the dispute; funds will be deducted.No - Review the ruling and adjust internal processes if needed.
AGREE_CBThe merchant has agreed to the dispute (no evidence submitted).No - Case will be closed as "lost" automatically.
CANCELDispute has been canceled (e.g., initiated in error).No - No further action required.
CLOSEDDispute process is fully completed (final status).No - Case is archived; no additional updates.