{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/hosted-checkout/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Order Statuses","description":"Official Banxa API documentation – on-ramp and off-ramp transfers with identity verification and compliance.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"order-statuses","__idx":0},"children":["Order Statuses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every Banxa order moves through a sequence of statuses from creation to completion. The order response from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/buy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/sell"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/orders"]}," all include an order status field."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may want to group or map these statuses into something more meaningful for the experience you present to your customers."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"status-reference","__idx":1},"children":["Status reference"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Definition"},"children":["Definition"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order has been created and the customer has submitted KYC information. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buy:"]}," waiting for customer payment. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sell:"]}," waiting for required conditions before Banxa can accept the crypto payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["waitingPayment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buy:"]}," customer has submitted payment information; waiting for final confirmation from external payment systems. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sell:"]}," all conditions are met and the customer needs to send crypto to the provided wallet address. This webhook signals that cryptocurrency is ready to be sent to Banxa."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentReceived"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment confirmed. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buy:"]}," fiat payment received. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sell:"]}," crypto payment received."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inProgress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment information has been received by external payment systems. The order is in final verification and processing."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cryptoTransferred"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cryptocurrency transaction has been submitted to the blockchain."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order completed. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buy:"]}," deemed complete after 2 blockchain confirmations. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sell:"]}," deemed complete when fiat has been successfully sent to the customer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order cancelled by Banxa due to internal risk and compliance alerts."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["declined"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order declined by external payment systems."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order created but payment not received within the expiry window. Expiry times vary by payment method. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," expired orders can become active again — if payment is received after expiry, the order will automatically continue through the normal processing stages."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refunded"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order refunded by Banxa customer support at the customer's request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extraVerification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order held for additional verification (e.g., ID or address verification). Banxa customer support will contact the customer to resolve the order."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typical-on-ramp-buy-flow","__idx":2},"children":["Typical on-ramp (buy) flow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n A([Order created]) -->|pendingPayment| B[KYC]\n B -->|pendingPayment| C[Payment]\n C -->|cancelled / declined| D([cancelled / declined])\n D -->|timeout| E([expired])\n C -->|paymentReceived| F[Order\\nexecution]\n F -->|inProgress| G{Verified?}\n G -->|cryptoTransferred| H[Crypto sent\\nto wallet]\n H -->|complete| Z([complete])\n G -->|inProgress| I[Manual\\nreview]\n I -->|resolved| Z\n I -->|timeout| E\n","diagramHtml":"","diagramHtmlDark":""},"children":["flowchart LR\n A([Order created]) -->|pendingPayment| B[KYC]\n B -->|pendingPayment| C[Payment]\n C -->|cancelled / declined| D([cancelled / declined])\n D -->|timeout| E([expired])\n C -->|paymentReceived| F[Order\\nexecution]\n F -->|inProgress| G{Verified?}\n G -->|cryptoTransferred| H[Crypto sent\\nto wallet]\n H -->|complete| Z([complete])\n G -->|inProgress| I[Manual\\nreview]\n I -->|resolved| Z\n I -->|timeout| E\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For instant payment methods (card, Apple Pay), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["waitingPayment"]}," may be bypassed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typical-off-ramp-sell-flow","__idx":3},"children":["Typical off-ramp (sell) flow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n A([Order created]) -->|pendingPayment| B[KYC + bank\\ndetails]\n B -->|waitingPayment| C[Awaiting\\ncrypto transfer]\n C -->|cancelled / declined| D([cancelled / declined])\n D -->|timeout| E([expired])\n C -->|paymentReceived| F[Fiat payout\\nprocessing]\n F -->|inProgress| G{Verified?}\n G -->|complete| Z([complete])\n G -->|inProgress| I[Manual\\nreview]\n I -->|resolved| Z\n I -->|timeout| E\n","diagramHtml":"","diagramHtmlDark":""},"children":["flowchart LR\n A([Order created]) -->|pendingPayment| B[KYC + bank\\ndetails]\n B -->|waitingPayment| C[Awaiting\\ncrypto transfer]\n C -->|cancelled / declined| D([cancelled / declined])\n D -->|timeout| E([expired])\n C -->|paymentReceived| F[Fiat payout\\nprocessing]\n F -->|inProgress| G{Verified?}\n G -->|complete| Z([complete])\n G -->|inProgress| I[Manual\\nreview]\n I -->|resolved| Z\n I -->|timeout| E\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["waitingPayment"]}," is the signal for custodial integrations to execute the crypto transfer. Once Banxa receives the crypto (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentReceived"]},"), the fiat payout is processed."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"terminal-statuses","__idx":4},"children":["Terminal statuses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following statuses are final — the order will not progress further:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["declined"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refunded"]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]}," is not always terminal. Orders can resume if payment is received after the expiry time. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extraVerification"]}," is a hold state — the order will resume once verification is resolved by Banxa support."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"checking-order-status","__idx":5},"children":["Checking order status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can retrieve the current status of any order via the order lookup endpoint, or receive status updates automatically via webhooks."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/transaction-lifecycle/order-lookup"},"children":["Order Lookup"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/transaction-lifecycle/webhooks"},"children":["Webhooks"]},"."]}]},"headings":[{"value":"Order Statuses","id":"order-statuses","depth":1},{"value":"Status reference","id":"status-reference","depth":2},{"value":"Typical on-ramp (buy) flow","id":"typical-on-ramp-buy-flow","depth":2},{"value":"Typical off-ramp (sell) flow","id":"typical-off-ramp-sell-flow","depth":2},{"value":"Terminal statuses","id":"terminal-statuses","depth":2},{"value":"Checking order status","id":"checking-order-status","depth":2}],"frontmatter":{"title":"Order Status Reference Guide | Banxa Docs","description":"All Banxa order statuses: pendingPayment, waitingPayment, paymentReceived, inProgress, complete, and more — with distinct buy and sell flow definitions.","seo":{"title":"Order Statuses"}},"lastModified":"2026-05-19T23:30:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/hosted-checkout/docs/transaction-lifecycle/order-statuses","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}