Sending Blockchain Payments - Lead | API Docs

Use the blockchain_payments endpoint to initiate outgoing payments, starting from USD and ending in stablecoins or foreign currency.

On-ramp: USD → stablecoins. A program, or its end customer, turns dollars in their own Lead account into stablecoin sent out to a wallet. The money is leaving the account over the blockchain rail.
FX Payout: USD → stablecoins → FX. A program, or its end user, turns dollars in their own Lead account into a foreign currency, moving over blockchain rails.

The endpoint assumes 1:1 for USD <> stablecoin value.

Requirements

Endpoint enabled & account limits set
An active account_number_id funded with USD. See Create an Account Number.

Statuses & webhooks

Status	Definition	Webhook
created	The payment exists and can be canceled.	blockchain_payment.created Note: We do not send this webhook for outgoing payments
under_review	Lead is manually reviewing the payment.	blockchain_payment.under_review
submitted	The payment has moved out of the anchored account number.	blockchain_payment.submitted
posted	The payment has completed. This is a terminal state.	blockchain_payment.posted
`rejected`	The payment failed validation before funds moved from or to the anchored account number. No second object is created; the original transitions to `rejected`. See Returns & Rejections.	`blockchain_payment.rejected`
canceled	The payment was canceled before submission. This could be done by the partner.	blockchain_payment.canceled

Lifecycle

Blockchain Payments Status Life Cycle

Returns

A return is modeled as a separate linked object: when a return occurs, the original object transitions to posted and the linked return object carries the reversal. See Returns & Rejections.