Guides

Order Processing Status

371
StatusDescription
RUNNING_CHECKSNewly created orders are created in the RUNNING_CHECKS state. In this state we are processing the request and seeing if the customer is eligible to transact.

If the checks fail the order will immediately transition to FAILED.

If the checks pass the order will transition to PROCESSING.
PROCESSINGOrders in the PROCESSING state have passed the checks and the user's payment information has been validated. At this point a Transfer has been created on Wyre for the user's Order. Orders in this state will have the transferId field populated and more status information can be pulled from the Track Widget Order API.
FAILEDOrders in the FAILED state have failed and cannot be processed. If we had additional information on why the order failed we provide it
COMPLETEOrders in the COMPLETE state are complete and the funds have been confirmed on the blockchain.

More on PROCESSNG

When an order enters PROCESSING that means that a Transfer has been created that represents the fulfillment of the Order.

While it is not a requirement that you monitor the details of the state in PROCESSING it can make for a better user experience. For example, you could tell the user their funds are on the way before the funds are fully confirmed on the blockchain.

If you wish to track the Transfer to provide additional context to the user we provide an unauthenticated endpoint that can be called directly from your UI. The details of that endpoint can be found on Wallet Order Details.

In the case of Orders, funds have already been secured before the Transfer is created. That means that there is really just one thing you need to worry about for the Transfer: when the funds are processed on the blockchain.

There are 3 different states here:

  • Blockchain Tx has not been submitted to the network - in this state the Transfer Tracker's blockchainNetworkTx object will appear as null
  • Blockchain Tx has been submitted to the network, but has not been confirmed -in this state the Transfer Tracker's blockchainNetworkTx object will be present
  • Blockchain Tx has been confirmed - Transfer Tracker will appear as with a COMPLETE status