Skip to main content
Use the blockchain_payments endpoint to initiate outgoing payments, starting from USD and ending in stablecoins or foreign currency.
  1. 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. 
  2. 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 

Statuses & webhooks

The statuses an outgoing blockchain payment moves through, and the webhook each one sends:
StatusDefinitionWebhook
createdThe payment exists and can be canceled.blockchain_payment.created

Note: Lead does not send this webhook for outgoing payments
under_reviewLead is manually reviewing the payment.blockchain_payment.under_review
submittedThe payment has moved out of the anchored account number.blockchain_payment.submitted
postedThe payment has completed. This is a terminal state.blockchain_payment.posted
rejectedThe 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
canceledThe payment was canceled before submission. This can be done 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 toposted and the linked return object carries the reversal. See Returns & Rejections.