> ## Documentation Index > Fetch the complete documentation index at: https://docs.rails.wayex.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an AUD payout > Creates an AUD payout to a saved beneficiary and durably reserves its source debit from this tenant account’s AUD wallet. ## What this endpoint does Creates an AUD payout to a saved beneficiary and durably reserves its source debit from this tenant account’s AUD wallet. ## When to use it Submit it after choosing the beneficiary, confirming the amount and purpose, and reviewing the effective fee and available balance. ## Before you call Use a secret API key with `treasury:write`. The beneficiary, its accepted evidence when required, limits, BSB/account rail, and wallet balance must all be eligible. Sumsub share tokens are submitted with beneficiary creation, not here. ## Money and balance effect On acceptance, the payout source debit is reserved so it cannot be spent twice. Settlement captures the reservation; a proven pre-settlement failure releases it, while returns follow the configured return policy. ## States and completion `accepted` means policy passed and funds are reserved. `held` needs review; `submitted` reached the bank rail; `settled`, `failed`, and `returned` describe later outcomes. ## Safe retries Send a unique `Idempotency-Key` for the logical action. If the response is lost, retry the same payload with the same key; never create a new key merely because the first response timed out. Read [Beneficiaries and payouts](/treasury/beneficiaries-and-payouts) for the complete workflow. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/treasury/payouts openapi: 3.0.0 info: title: Wayex API description: >- Wayex APIs for direct customer payment routes and isolated, prefunded Treasury accounts. Each API key is bound to one tenant account and its own wallet, settings, webhooks, and reporting. version: 1.0.0 contact: {} servers: - url: https://api.sandbox.wayex.com description: Sandbox integration environment security: - Bearer: [] - ApiKey: [] tags: - name: Treasury description: >- Prefunded AUD and stablecoin wallets for one isolated tenant account. Fund, pay, convert, withdraw, track, and reconcile without selecting another account. - name: Customers description: >- Onboard end customers, run verification, and manage each customer's entitlements. - name: Payment routes description: >- Standing deposit instructions per customer. When a customer funds a route, Wayex auto-converts at the live rate and pays out/sends — no quote, no lock. - name: Transfers description: >- Read the conversion records produced when customers fund payment routes — the live activity feed and per-conversion lifecycle timeline. - name: Rates description: >- The live indicative AUD↔stablecoin rate right now — the all-in rate Wayex quotes. Indicative only; the binding price is struck when a route's funds land. - name: Revenue description: Your developer-fee revenue over time. - name: Invoices description: >- Your monthly invoices — Wayex platform fees due, net of your accrued developer-fee credit. - name: Webhooks description: Subscribe to HMAC-signed event webhooks and inspect deliveries. - name: API keys description: Create, list, and rotate API keys for programmatic access. - name: Fees description: >- Configure your developer fee — the markup withheld from each conversion and credited against your monthly invoice. - name: Invitations description: Accept a team invitation and activate your account. paths: /v1/treasury/payouts: post: tags: - Treasury summary: Create an AUD payout description: >- Creates an AUD payout to a saved beneficiary and durably reserves its source debit from this tenant account’s AUD wallet. Submit it after choosing the beneficiary, confirming the amount and purpose, and reviewing the effective fee and available balance. operationId: TreasuryController2_createPayout_v1 parameters: - name: Idempotency-Key in: header required: true description: >- A unique key for this logical action. Reuse the same key and identical payload when retrying after an unknown response. schema: type: string minLength: 8 maxLength: 255 example: 13bda8d7-87bd-4fa4-b7d5-e740725f9bd2 requestBody: required: true content: application/json: schema: type: object properties: beneficiaryId: type: string minLength: 1 amount: type: string pattern: ^\d+(\.\d+)?$ currency: type: string enum: - AUD externalReference: type: string minLength: 1 purpose: type: string minLength: 1 maxLength: 255 walletProviderReference: type: string minLength: 1 downstreamMerchantReference: type: string minLength: 1 evidenceId: type: string minLength: 1 required: - beneficiaryId - amount - currency - externalReference - purpose responses: '201': description: '' content: application/json: schema: type: object properties: id: type: string minLength: 1 clientId: type: string minLength: 1 beneficiaryId: type: string minLength: 1 amount: type: object properties: amount: type: string pattern: ^\d+(\.\d+)?$ currency: type: string enum: - AUD - USDC - USDT network: type: string enum: - ethereum - base - arbitrum - optimism - polygon - bsc - avalanche - solana - tron required: - amount - currency fee: type: object properties: amount: type: string pattern: ^\d+(\.\d+)?$ currency: type: string enum: - AUD - USDC - USDT network: type: string enum: - ethereum - base - arbitrum - optimism - polygon - bsc - avalanche - solana - tron required: - amount - currency sourceDebit: type: object properties: amount: type: string pattern: ^\d+(\.\d+)?$ currency: type: string enum: - AUD - USDC - USDT network: type: string enum: - ethereum - base - arbitrum - optimism - polygon - bsc - avalanche - solana - tron required: - amount - currency status: enum: - accepted - held - submitted - settled - failed - returned type: string configurationId: type: string minLength: 1 externalReference: type: string minLength: 1 purpose: type: string minLength: 1 maxLength: 255 walletProviderReference: type: string minLength: 1 downstreamMerchantReference: type: string minLength: 1 evidenceId: type: string minLength: 1 providerReference: type: string minLength: 1 statusReason: type: string minLength: 1 reservation: type: object properties: status: type: string enum: - reserved - captured - released amount: type: object properties: amount: type: string pattern: ^\d+(\.\d+)?$ currency: type: string enum: - AUD - USDC - USDT network: type: string enum: - ethereum - base - arbitrum - optimism - polygon - bsc - avalanche - solana - tron required: - amount - currency required: - status - amount nextAction: type: string enum: - none - wait_for_settlement - contact_support - retry_new_request - review_balance createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - id - clientId - beneficiaryId - amount - fee - sourceDebit - status - configurationId - externalReference - purpose - reservation - nextAction - createdAt - updatedAt security: - Bearer: [] - ApiKey: [] components: securitySchemes: Bearer: type: http scheme: bearer bearerFormat: Wayex API key description: 'Send the same Wayex API key as `Authorization: Bearer `.' ApiKey: type: apiKey in: header name: X-Api-Key description: A Wayex API key. Use a secret key for write operations. ````