Skip to main content

Transaction Status Codes

TOPPAY TeamLess than 1 minute

Overview

The status field (and statusMsg in Pay-Out) appears in Pay-In and Pay-Out requests, inquiries, and asynchronous notifications. The tables below apply to all fiat countries, to crypto Pay-Out, and to crypto Pay-In callbacks. Crypto Pay-In inquiry returns a display status (WAITING / SUCCESS / FAILED / EXPIRED) instead of the strings in this table; see Crypto order inquiry. If the gateway returns a value that is not listed, rely on the actual response and operational guidance.

Field types

  • Pay-In: status is usually a string (e.g. SUCCESS).
  • Pay-Out: status is usually a number (99, 0–5), consistent with Order Status Inquiry.

Pay-In status

Applies to status in Pay-In orders, Order Inquiry, and Pay-In notifications for all fiat countries, and to crypto Pay-In callbacks. Crypto Pay-In inquiry is documented in Crypto order inquiry.

ValueDescription
INIT_ORDEROrder initialized
NO_PAYUnpaid
SUCCESSPayment successful
PAY_CANCELCancelled
PAY_ERRORPayment failed

Some examples may show additional string values; rely on the actual response.

Pay-Out status

Applies to numeric status in Pay-Out orders, Order Inquiry, and Pay-Out notifications for all fiat countries, and to crypto Pay-Out. Crypto statusMsg wording is documented in Crypto Pay-Out.

Important

Except for statuses 2, 3, and 4, all other statuses indicate "processing"; orders in these states must not be directly treated as failed.

ValueDescription
99Created
0Pending
1Accepted
2Payout successful
3Refund / chargeback
4Payout failed
5Bank processing

statusMsg is a human-readable hint (e.g. ORDER_RECEIVED_PROCESSING, supplement success!). Use the numeric status for business logic.