Documentation Index
Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt
Use this file to discover all available pages before exploring further.
Payouts
A payout sends money from your business wallet directly to a Fyatu account holder. Funds are transferred instantly and the recipient receives a notification.
Flow
Statuses
| Status | Description |
|---|
PENDING | Processing |
COMPLETED | Successfully delivered |
FAILED | Failed to process |
Fees
Payout fees are added on top of the amount you send — your wallet is debited for the total:
| Payout Amount | Fee | Total Debited |
|---|
| $25.00 | $0.50 | $25.50 |
| $100.00 | $0.50 | $100.50 |
Best Practices
- Verify first: always call
GET /accounts/{clientId} before creating a payout — confirm the recipient exists and is active
- Use references: pass a unique
reference on every payout for reconciliation and support traceability
- Check balance: ensure your wallet has sufficient funds (amount + fee) before sending
Error Codes
| Code | Cause | Resolution |
|---|
INSUFFICIENT_BALANCE | Wallet balance too low | Top up your business wallet |
PAYOUT_LIMIT_EXCEEDED | Exceeds daily or monthly limit | Wait for limit reset or contact support |
RECIPIENT_INACTIVE | Recipient account not active | Recipient must activate their Fyatu account |
Endpoints
