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.
Fyatu API
The Fyatu API lets you embed financial infrastructure directly into your product. Issue virtual Mastercard prepaid cards, accept payments from Fyatu users, and send payouts — all through a single REST API.Quick Start
Make your first API call in minutes
Authentication
JWT tokens, scopes, and best practices
API Reference
Browse all endpoints and schemas
Webhooks
Receive real-time event notifications
What You Can Build
Virtual Card Issuing
Virtual Card Issuing
Issue Mastercard prepaid virtual cards to your cardholders programmatically. Fund them on creation, add balance at any time, freeze or unfreeze, and terminate when no longer needed. Full card details (PAN, CVV, expiry) are available via API.
Payment Collections
Payment Collections
Create checkout sessions and accept payments from Fyatu users. Customers are redirected to a hosted checkout page and you receive a webhook notification on completion. Refunds are also supported.
Payouts & Disbursements
Payouts & Disbursements
Send payouts to verified external accounts. Ideal for vendor payments, affiliate disbursements, and salary payouts.
Cardholder Management
Cardholder Management
Create and manage the individuals associated with your issued cards. Collect KYC documents or initiate a hosted KYC verification session before issuing cards.
Base URL
App-Based Access
Every API call is scoped to an App you create in your Business Console. The app type determines which APIs are available:| App Type | APIs Available | Scopes Granted |
|---|---|---|
| Collection App | Collections, Payouts, Refunds | collect:write, collect:read, payout:write, payout:read |
| Issuing App | Cards, Cardholders | cards:write, cards:read, cardholders:write, cardholders:read |
Getting Started
Create a Fyatu account
Sign up at web.fyatu.com and complete identity verification (KYC).
Upgrade to Business
Upgrade your account to Business from the dashboard to access the Business Console.
Create an App
In the Business Console, create a Collection App or an Issuing App depending on what you want to build.
Get your credentials
From your app’s Settings → API Keys & Credentials, copy your
appId and secretKey.Ready to start?
Follow the quickstart guide to make your first API call
Key Concepts
| Concept | Description |
|---|---|
| JWT tokens | Short-lived access tokens (24 h) scoped to your app type. Refresh up to 5 minutes after expiry. |
| Scopes | Each token carries the permissions granted to its app type. Calls outside the scope return 403. |
| requestId | Every response includes a meta.requestId — use it when contacting support. |
| Webhooks | HMAC-SHA256 signed callbacks for every significant event. Verify the signature before trusting the payload. |
| Business wallet | Your USD balance used to fund card issuance, payouts, and fees. Replenish via USDT deposit. |