| Status | Description |
|---|---|
awaiting_funds | Bridge is waiting to receive funds from the customer before processing the transfer. This applies to incoming crypto deposits, wires, or ACH pushes. |
in_review | A rare, temporary state triggered when transfer data needs further confirmation. Typically resolves in seconds; otherwise, Bridge will reach out within 24 hours. |
funds_received | Bridge has received the funds and is preparing to move them on the customer’s behalf. |
payment_submitted | Bridge submitted the crypto payment. Important: the transaction hash provided at this stage may be preliminary and is not guaranteed to be final. Please use the transaction hash returned in the payment_processed state as the finalized transaction hash. |
payment_processed | The transfer is complete and funds have been successfully delivered to the destination. |
undeliverable | Bridge was unable to deliver funds due to an issue like an invalid account or unsupported asset at the destination. |
returned | The payment was sent but failed. Funds have returned to Bridge and a refund to the sender is underway. |
missing_return_policy | In order for us to return the crypto deposit, we need you to configure a crypto return policy with us. Please refer here. |
refunded | The payment was refunded Bridge no longer has the funds. This means the payment was either sent back to the original sender, refunded based on the configured crypto return policy, or sent back to the originating Bridge wallet or Bridge prefunded account. |
refund_in_flight | A refund has been initiated and is in progress. |
refund_failed | A refund attempt failed. |
canceled | The transfer was canceled. This can only happen from the awaiting_funds state via the DELETE /v0/transfers/{transferID} endpoint. |
error | A problem occurred that blocked processing. This typically requires manual review or developer action. |
- Please note that a transfer will always progress from
awaiting_funds→funds_received→payment_submitted→payment_processed. It can never go backwards. - States including
returned,refunded,undeliverable, orerrorindicate exception paths.