VPOS orders can be in any of the following states:

  • NewWidget initialized
  • CompletedPayment process completed
  • Error: Payment Error
  • Partially Refunded: Payment partially refunded
  • Refunded: Payment refunded
  • Confirmed: Funds settled (TPV escrow only)
  • Fraud: Fraud rule triggered


  • Payments will be in state 1 by default.
  • Payments in state 1 can be retried by starting the widget with the same order_code.
  • Payment in state 3 can be refunded using the method POST Refund
  • Payments in state 10 means that the callback from the PSP has not been received. This is a temporary state so it will be updated to it's final state (Completed or Error).