Receive real-time notifications about order events and state changes
INITIATED
to DEPOSITED
.
200 OK
HTTP status code with no response body
.200 0K
HTTP response code on receipt of webhook data, there will be subsequent attempts to resend it until the retry attempts are exhausted.apiSecret
is the same as the one configured from your Business portal dashboard.data
is an object which is peculiar to the specific webhook context.order.state_transition
Event | Description |
---|---|
order.state_transition | Triggered when an order’s state changes, such as from INITIATED to DEPOSITED . Includes detailed payload data for tracking. |
State | Description | Is terminal | Allowed transition |
---|---|---|---|
PENDING | This is an order’s initial state when instantiated by a user | No | AWAITING_ACCEPTANCE INITIATED CANCELLED |
AWAITING_ACCEPTANCE | For orders that require prior acceptance before being initiated, this state indicates that the merchant is yet to accept the order. This is usually because the merchant turned off auto-escrow on their ad, or the customer is selling an ERC-20 token. | No | CANCELLED INITIATED |
INITIATED | The order has been create onchain, but the buyer hasn’t confirmed sending fiat to the seller | No | CANCELLED DEPOSITED IN_DISPUTE |
DEPOSITED | This indicates that the buyer has confirmed making a fiat transfer to the seller | No | CONFIRMED CANCELLED IN_DISPUTE |
CONFIRMED | The seller has confirmed receipt of fiat | No | COMPLETED |
IN_DISPUTE | A participant in the transaction has raised a dispute | No | CANCELLED CONFIRMED |
COMPLETED | The order has been completed and closed on chain | Yes | N/A |
CANCELLED | The order was cancelled | Yes | N/A |
terminal
state indicates that the state/status cannot be reversed, or transition to a different state.