Understand the lifecycle of an instant bank transfer and manual bank transfer.
order
object. Use the order.status
field to trigger actions in your system.
Poll the Order Status
Set up Webhooks
order_updated
event to receive real-time updates through Webhooks for every status changeorder_updated
with all Order fields, including the order.status
field. Monitor the field order.status
to update your system accordingly.waiting_for_payment
, paid
, finalizing
, canceled
Terminal Status: Nocanceled
, the incoming transaction is returned automatically.Next possible statuses: None (terminal status)Terminal Status: Yes (for all Orders)waiting_for_payment
will be skipped and instead the paid
status will be setpaid
, finalizing
, failed
Terminal Status: No (Yes for payments with direct settlement)paid
, canceled
Terminal Status: NopaymentMode
isinstant_preferred
or standard
) or within 24 hours (instant_only
) and will not arrive anymore.If money arrives after this time, it is returned automatically to the payer.Next possible statuses: None (terminal status)Terminal Status: Yes (for all Orders)waiting_for_payment
will be skipped and instead the paid
status will be setin_refund
Terminal Status: Yes (unless you trigger a Refund process)refunded
, partially_refunded
Terminal Status: Noin_refund
Terminal Status: No