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.
Requirements
- Endpoint enabled & account limits set
- An active
account_number_idfunded with USD. See Create an Account Number.
Statuses & webhooks
The statuses an outgoing blockchain payment moves through, and the webhook each one sends:| Status | Definition | Webhook |
|---|---|---|
created | The payment exists and can be canceled. | blockchain_payment.createdNote: Lead does 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 Validations & Best Practices. | blockchain_payment.rejected |
canceled | The payment was canceled before submission. This can be done the partner. | blockchain_payment.canceled |
Lifecycle

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

