Skip to content

Order status

Order status

VellPay uses string statuses to represent the current order stage. A processing status returned by a create endpoint does not mean the transaction ultimately succeeded. Merchants must confirm the final result using query endpoints and asynchronous callbacks.

Pay-in and checkout statuses

StatusDescriptionFinal status
INITOrder accepted; waiting for the payment flowNo
PAYINGPayment processingNo
SUCCESSPay-in completed successfullyYes
FAILPay-in failedYes
REFUNDPay-in funds refundedYes

Payout statuses

StatusDescriptionFinal status
INITPayout acceptedNo
PAYINGPayout processingNo
SUCCESSPayout completed successfullyYes
FAILPayout failedYes
REFUNDPayout funds fully returnedYes
PART_REFUNDPayout funds partially returnedNo

Integration recommendations

  • Do not determine the transaction result from only the HTTP status code or response code.
  • INIT and PAYING are non-final statuses; continue receiving callbacks or querying the order.
  • Handle duplicate callbacks idempotently using tradeNo and status.
  • If query and callback results differ, use the platform final status and contact technical support to investigate an abnormal status reversal.

KYC statuses

StatusDescriptionFinal status
PENDINGWaiting for user verificationNo
REVIEWINGVerification under reviewNo
APPROVEDVerification approvedYes
REJECTEDVerification rejectedYes
FILAVerification failedYes