***

title: How to Track Order Status
slug: guides/track-order-status
subtitle: 'Monitor order lifecycle with APIs, webhooks, and WebSocket updates'
------------------------------------------------------------------------------

Track the status of user orders and receive real-time updates using any of the following integration options:

<CardGroup cols={2}>
  <Card title="REST API" icon="fa-light fa-server" iconPosition="left" href="/api/public/end-points">
    Poll order status on demand or for reconciliation.
  </Card>

  <Card title="Webhooks" icon="fa-light fa-webhook" iconPosition="left" href="/features/webhooks">
    Receive push notifications when order status changes.
  </Card>
</CardGroup>

<CardGroup cols={1}>
  <Card title="WebSockets" icon="fa-light fa-wave-square" iconPosition="left" href="/features/websockets">
    Subscribe to near real-time order status streams.
  </Card>
</CardGroup>

## Order Flow

<Frame>
  <img src="https://files.buildwithfern.com/visual-editor-images/transak-labs.docs.buildwithfern.com/2026-03-11T13:28:50.225Z/guides/tracking-order-status/cca71ca-ORDER_STATUS_Final.jpg" alt="Order Status Flow Diagram" title="cca71ca-ORDER_STATUS_FinalaOrder Status Flow DiagramaOrder Status Flow Diagram" noZoom={false} />
</Frame>

## Order Status Reference

<Tabs>
  <Tab title="On-Ramp / NFT Checkout">
    | Status Code                             | Description                                                                                                  |
    | --------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
    | `AWAITING_PAYMENT_FROM_USER`            | When the order is created but the payment still not received.                                                |
    | `PAYMENT_DONE_MARKED_BY_USER`           | When the user marks the payment as done but it is received by us yet.                                        |
    | `PROCESSING`                            | Orders in the PROCESSING state have passed the checks and the user's payment information has been validated. |
    | `PENDING_DELIVERY_FROM_TRANSAK`         | When the payment is received and being exchanged & transferred via us or our liquidity partner.              |
    | `ON_HOLD_PENDING_DELIVERY_FROM_TRANSAK` | Order is on hold.                                                                                            |
    | `COMPLETED`                             | When we have received the payment and the crypto is sent successfully to the user.                           |
    | `CANCELLED`                             | Order is cancelled.                                                                                          |
    | `FAILED`                                | When the order is failed, e.g.: because of the card decline.                                                 |
    | `REFUNDED`                              | Order is refunded to the user.                                                                               |
    | `EXPIRED`                               | When the user failed to make the payment within the timeframe.                                               |
  </Tab>

  <Tab title="Off-Ramp">
    | Status Code                             | Description                                                                                                                                                                           |
    | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | `AWAITING_PAYMENT_FROM_USER`            | When the order is created but the payment still not received.                                                                                                                         |
    | `PAYMENT_DONE_MARKED_BY_USER`           | When the user marks the payment as done but it is not yet received by us.                                                                                                             |
    | `PENDING_DELIVERY_FROM_TRANSAK`         | When the payment is received and being exchanged & transferred via us or our liquidity partner.                                                                                       |
    | `ON_HOLD_PENDING_DELIVERY_FROM_TRANSAK` | When the crypto payment is received and being exchanged & fiat being transferred via our banking partner but because of some issue our system is unable to send the fiat to the user. |
    | `COMPLETED`                             | When we have received the crypto payment and fiat is sent successfully to the user's bank account.                                                                                    |
    | `CANCELLED`                             | Order is cancelled.                                                                                                                                                                   |
    | `FAILED`                                | When the order is failed, e.g.: because of the card decline.                                                                                                                          |
    | `REFUNDED`                              | Order is refunded to the user.                                                                                                                                                        |
    | `EXPIRED`                               | When the user failed to make the payment within the timeframe.                                                                                                                        |
  </Tab>
</Tabs>

## Use Cases

<Steps>
  <Step title="Returning User — Skip KYC">
    Check if the user has already onboarded with Transak. If so, remind them they don't need to complete KYC again.
  </Step>

  <Step title="Pending Order — Resume Flow">
    Check if the user has a pending order and direct them to complete it rather than starting a new one.
  </Step>

  <Step title="Failed Order — Retry with Different Card">
    If an order fails, direct the user to retry with a different payment method or card.
  </Step>

  <Step title="Disabled User — Risk Decisions">
    Use Transak's user status signals (e.g. disabled user) as an input into your own risk management decisions.
  </Step>
</Steps>