destination_payment_rail
:
return_address
so we know where to send funds to if your customer’s transaction fails or is returned by the destination.state
field tracks the status of each drain through its lifecycle. Here are the possible values:
State | Description |
---|---|
in_review | The transaction is temporarily held for review. This usually clears automatically. If unresolved after 24 hours, Bridge will contact you. |
funds_received | Bridge has received crypto and is preparing the outgoing payment. |
payment_submitted | The outgoing payment has been sent. Confirmation pending (varies by payment rail). |
payment_processed | Payment successfully completed. Depending on the rail, metadata may include a tx_hash , imad , or trace_number . |
undeliverable | Bridge could not deliver the payment (e.g. invalid account or unsupported asset). |
returned | Payment was sent but later rejected and returned to Bridge. |
refunded | Funds that were returned have been re-sent to an alternative destination. |
error | A system or network issue prevented processing. Manual intervention may be required. |
canceled | The payment was canceled before submission—usually due to AML/EFE review or because it did not meet the minimum transfer threshold. |
Drains can only move forward (funds_received
→payment_submitted
→payment_processed
) and cannot go backward.