Recipient Payouts
Send funds to third-party recipients and recipient-owned bank accounts.
Recipient payouts send funds to third parties such as vendors, contractors, employees, counterparties, and other payees. Create the recipient, add a recipient bank account, execute the payout, and track the transfer.
Recipient Payout Workflow
Recipient bank accounts are separate from customer external accounts so first-party and third-party payouts stay explicit. Use POST /v1/payout with the recipient account ID (racc_*) for supported recipient payout rails. SEPA recipient payouts are not currently supported.
Recipient account creation requires the matching customer rail to be ready_to_use. If the rail is missing or still under review, the API returns 409 rail_not_ready with requiredRails, requestRailEndpoint, and nextAction. Rail status IDs (cfr_*) are never valid recipient account IDs.
Endpoint Sequence
API Reference
| Operation | Use it for |
|---|---|
POST /v1/customers/{customerId}/recipients | Create a recipient. |
POST /v1/customers/{customerId}/recipients/{recipientId}/accounts | Create a recipient bank account. |
POST /v1/payout | Execute a payout. |
GET /v1/transfers/{id} | Track the payout transfer. |