Create a Payout
Creates a Payout in pending_approval. Idempotent on (Business, environment, idempotency_key) within 24h — a duplicate within the window returns the original Payout with HTTP 200. In sandbox the Business must have a funded sandbox wallet: an empty (or unprovisioned) one is refused with SANDBOX_WALLET_UNFUNDED (422) before anything is written, and completing the business profile funds it with test money.
Authorizations
Cleff API key issued to a Business that self-registers via POST /v1/registration
Body
Destination BankAccount for this disbursement. Must belong to the targeted Beneficiary and be in verified status.
Amount in minor units (e.g. cents). Max 9007199254740991 (2^53−1) to preserve JS integer precision.
x <= 9007199254740991ISO 4217 currency code
Caller-supplied idempotency key, scoped to (Business, environment); 24h short-circuit window.
Why the funds are being sent. Routefusion requires a purpose-of-payment on every transfer. Provisional corridor-agnostic set; coded values live behind the purpose-of-payment seam.
advertising, advisor_fees, charity, education, family_support, investment, loan_repayment, medical, other, payroll, purchase_of_goods, purchase_of_services, real_estate, royalties, taxes, treasury, travel Business-supplied reference (e.g. tradeId/jobId).
Override the per-Business default validator strategy for this Intent.
manual Self-link to a previously-failed Payout this Intent is replacing. The predecessor must be in failed state, belong to the same Business, and not have been replaced already.
Channel metadata. Server infers a default from the auth source (session→dashboard, API key→api). Clients may declare { channel: 'sdk', sdkVersion? } or { channel: 'cli', cliVersion? }; other channels are rejected.