Payouts

A payout lets a customer pay a beneficiary by sending crypto that is off-ramped and delivered as fiat to the beneficiary’s bank account. Unlike checkouts, where you receive stablecoins at your settlement address, a payout settles in fiat to a third party.

API-first (you build the payment UI)

Payouts are API-first — there is no hosted page. You create a payout, we return the customer’s deposit address(es), and you decide how to present them (QR, address, chain/token picker). You track progress through webhooks and the status endpoints. The crypto amount, chain/token selection, and any FX display are yours to render.

How It Works

1. Register a beneficiary — the payee bank account (once, reused).
2. Create a customer — the person paying. They complete KYC once and get persistent deposit_addresses.
3. Create a payout — POST /payouts with the customer_id, beneficiary_id, amount, and currency. This is a signed request.
4. The customer sends crypto to a deposit address, on any supported chain.
5. We off-ramp and pay the beneficiary — funds are forwarded to the off-ramp and delivered as fiat to the beneficiary’s bank. You receive payout.deposit_detected → payout.forwarded → payout.completed webhooks.

Key behaviors

• Variable amount, no schedule. You set the amount on each payout. A customer can pay different amounts, pay different beneficiaries, or skip periods — there is no subscription.
• One open payout per customer at a time. Creating a new payout while one is still pending is rejected, which keeps each deposit unambiguously matched to its payout.
• Customer must be active. Payout creation is rejected until KYC is complete.
• Signed. Each payout is authorized with the @exodus/checkout-signer SDK, the same signing model as direct and two-step payments. The signature names the beneficiary’s destination, so a payout can never be redirected without your key.
• Fee. A fixed fee is retained on each payout.

Available Endpoints

• Create Payout — Start a payout (signed)
• Get Payout — Retrieve a payout
• List Payouts — List all payouts