# FYATU API Docs

## Docs

- [Generate Deposit Address](https://docs.fyatu.com/v3/api-reference/account/deposit-address.md): Generate a USDT deposit address to fund your Fyatu business wallet. POST /account/deposit-address.
- [Get Invoices](https://docs.fyatu.com/v3/api-reference/account/invoices.md): List your business billing invoices — subscription charges, outstanding amounts, and payment status. GET /account/invoices.
- [Get Pricing](https://docs.fyatu.com/v3/api-reference/account/pricing.md): Retrieve current Fyatu API pricing and fee schedule — card issuance fees, funding fees, and transaction costs. GET /account/pricing.
- [Get Statement](https://docs.fyatu.com/v3/api-reference/account/statement.md): Get the last 100 ledger entries for your business account with running balance snapshots. GET /account/statement.
- [Get Transaction](https://docs.fyatu.com/v3/api-reference/account/transaction.md): Get details of a specific business wallet transaction by ID — category, amount, fee, status, and description. GET /account/transactions/{id}.
- [Get Transactions](https://docs.fyatu.com/v3/api-reference/account/transactions.md): List all business wallet transactions with category, status, and fee data. GET /account/transactions.
- [Get Wallet](https://docs.fyatu.com/v3/api-reference/account/wallet.md): Get your Fyatu business wallet balance and currency details. GET /account/wallet.
- [Request Withdrawal](https://docs.fyatu.com/v3/api-reference/account/withdraw.md): Request a withdrawal from your Fyatu business wallet to a registered address. POST /account/withdraw.
- [Register Withdrawal Address](https://docs.fyatu.com/v3/api-reference/account/withdrawal-address.md): Register a withdrawal destination address for your Fyatu business wallet. POST /account/withdrawal-address.
- [Get Withdrawals](https://docs.fyatu.com/v3/api-reference/account/withdrawals.md): List all withdrawal requests from your Fyatu business wallet with status tracking. GET /account/withdrawals.
- [Refresh Token](https://docs.fyatu.com/v3/api-reference/auth/refresh.md): Refresh an expiring Fyatu API access token without re-authenticating. POST /auth/refresh.
- [Revoke Token](https://docs.fyatu.com/v3/api-reference/auth/revoke.md): Revoke an active Fyatu API access token to invalidate a session. POST /auth/revoke.
- [Generate Token](https://docs.fyatu.com/v3/api-reference/auth/token.md): Generate a JWT access token for Fyatu API v3 using client credentials. POST /auth/token with appId and secretKey.
- [Create Cardholder](https://docs.fyatu.com/v3/api-reference/cardholders/create.md): Create a new cardholder for virtual card issuing. Submit personal details and start issuing cards immediately. POST /cardholders.
- [Delete Cardholder](https://docs.fyatu.com/v3/api-reference/cardholders/delete.md): Delete a cardholder and terminate all associated cards. This action is permanent. DELETE /cardholders/{id}.
- [Get Cardholder](https://docs.fyatu.com/v3/api-reference/cardholders/get.md): Get cardholder details including KYC status, personal information, and associated cards. GET /cardholders/{id}.
- [Submit KYC Documents](https://docs.fyatu.com/v3/api-reference/cardholders/kyc.md): Submit KYC identity documents for a cardholder on their behalf. Documents are sent to the verification provider for automated identity checks. POST /cardholders/{id}/kyc.
- [Initiate KYC Verification](https://docs.fyatu.com/v3/api-reference/cardholders/kyc-session.md): Start identity verification for a cardholder via automated ID + liveness check. Returns a verification URL. POST /cardholders/{id}/kyc/session.
- [List Cardholders](https://docs.fyatu.com/v3/api-reference/cardholders/list.md): List all cardholders in your Fyatu card program with pagination and KYC status filtering. GET /cardholders.
- [Update Cardholder](https://docs.fyatu.com/v3/api-reference/cardholders/update.md): Update cardholder personal information, metadata, or status. PATCH /cardholders/{id}.
- [Create Card](https://docs.fyatu.com/v3/api-reference/cards/create.md): Issue a new virtual Mastercard or Visa prepaid card programmatically. Specify cardholder, amount, and product. POST /cards.
- [Terminate Card](https://docs.fyatu.com/v3/api-reference/cards/delete.md): Permanently terminate a virtual card. Remaining balance is returned to your wallet. DELETE /cards/{cardId}.
- [Freeze Card](https://docs.fyatu.com/v3/api-reference/cards/freeze.md): Temporarily freeze a card to block all transactions. Card can be unfrozen later. POST /cards/{cardId}/freeze.
- [Fund Card](https://docs.fyatu.com/v3/api-reference/cards/fund.md): Add funds to an existing virtual card. Minimum $5, fee applies per pricing. POST /cards/{cardId}/fund.
- [Get Card Details](https://docs.fyatu.com/v3/api-reference/cards/get.md): Get full card details — masked number, expiry, brand, balance, status, and spending limits. GET /cards/{cardId}.
- [List Cards](https://docs.fyatu.com/v3/api-reference/cards/list.md): List all issued virtual and prepaid cards with pagination — filter by status, cardholder, or product. GET /cards.
- [List Card Products](https://docs.fyatu.com/v3/api-reference/cards/products.md): List available card products (BINs) — Mastercard World USD/EUR, Visa Platinum USD. Includes issuance fees and currency details. GET /cards/products.
- [Replace Card](https://docs.fyatu.com/v3/api-reference/cards/replace.md): Replace a card with a new one — same cardholder, new card number. POST /cards/{cardId}/replace.
- [Download Card Statement](https://docs.fyatu.com/v3/api-reference/cards/statement.md): Download a PDF statement for a card with transaction history, business branding, and card details. GET /cards/{id}/statement.
- [Get Card Transactions](https://docs.fyatu.com/v3/api-reference/cards/transactions.md): Get transaction history for a specific card — merchant name, amount, status, and timestamps. GET /cards/{cardId}/transactions.
- [Unfreeze Card](https://docs.fyatu.com/v3/api-reference/cards/unfreeze.md): Reactivate a previously frozen card to resume transactions. POST /cards/{cardId}/unfreeze.
- [Unload Card](https://docs.fyatu.com/v3/api-reference/cards/unload.md): Withdraw remaining balance from a card back to your business wallet. POST /cards/{cardId}/unload.
- [Create Collection](https://docs.fyatu.com/v3/api-reference/collections/create.md): Create a payment collection session with hosted checkout. Accept payments from customers with callback and webhook support. POST /collections.
- [Get Collection](https://docs.fyatu.com/v3/api-reference/collections/get.md): Get details of a specific payment collection — amount, status, checkout URL, and metadata. GET /collections/{id}.
- [List Collections](https://docs.fyatu.com/v3/api-reference/collections/list.md): List all payment collections with pagination and status filtering. GET /collections.
- [API Reference](https://docs.fyatu.com/v3/api-reference/overview.md): Complete REST API reference for Fyatu v3 — card issuing, payment collections, payouts, refunds, eSIM management, and webhook configuration endpoints.
- [Create Payout](https://docs.fyatu.com/v3/api-reference/payouts/create.md): Create an instant payout to a Fyatu user. Specify amount, recipient, and reference for reconciliation. POST /payouts.
- [Get Payout](https://docs.fyatu.com/v3/api-reference/payouts/get.md): Get details of a specific payout — amount, recipient, charges, net amount, and status. GET /payouts/{id}.
- [List Payouts](https://docs.fyatu.com/v3/api-reference/payouts/list.md): List all payouts with pagination and status filtering — initiated, completed, or failed. GET /payouts.
- [Verify Account](https://docs.fyatu.com/v3/api-reference/payouts/verify-account.md): Verify a Fyatu recipient account before sending a payout. Validate account existence and details. POST /payouts/verify-account.
- [Authentication](https://docs.fyatu.com/v3/documentation/authentication.md): JWT-based authentication for Fyatu API v3. Generate access tokens with your appId and secretKey. Tokens valid for 24 hours with refresh and revoke support.
- [Cardholders](https://docs.fyatu.com/v3/documentation/concepts/cardholders.md): Cardholder management in Fyatu's card issuing platform. Create cardholders, issue virtual cards immediately, and optionally verify identity via KYC.
- [Cards](https://docs.fyatu.com/v3/documentation/concepts/cards.md): Issue, fund, freeze, and manage virtual Mastercard and Visa prepaid cards through Fyatu's card issuing API. 3D Secure, Apple Pay, and Google Pay support.
- [Payments](https://docs.fyatu.com/v3/documentation/concepts/payments.md): Understanding Fyatu's payment infrastructure — collections for inbound payments, payouts for outbound transfers, and refunds. Accept payments and disburse funds via API.
- [Error Handling](https://docs.fyatu.com/v3/documentation/errors.md): Fyatu API error codes and HTTP status codes. Handle validation errors, insufficient balance, invalid tokens, and provider failures in your card issuing integration.
- [Overview](https://docs.fyatu.com/v3/documentation/introduction.md): Fyatu API v3 documentation — issue virtual Visa and Mastercard prepaid cards, collect payments, send payouts, and manage eSIMs programmatically via REST API.
- [Quick Start](https://docs.fyatu.com/v3/documentation/quickstart.md): Get started with Fyatu's card issuing API in under 5 minutes. Authenticate, create a cardholder, issue your first virtual Mastercard, and set up webhooks.
- [Crypto Exchanges](https://docs.fyatu.com/v3/use-cases/crypto-exchanges.md): Enable fiat on/off ramps for cryptocurrency exchanges — accept deposits and process withdrawals via Fyatu's payment API.
- [E-commerce Platforms](https://docs.fyatu.com/v3/use-cases/ecommerce.md): Power checkout for online marketplaces and e-commerce stores across Africa with Fyatu's payment collection API.
- [Fintech Startups](https://docs.fyatu.com/v3/use-cases/fintech.md): Build neobanks, lending apps, and digital wallets with Fyatu's card issuing API — virtual Mastercard and Visa cards, KYC, and real-time webhooks.
- [Forex Brokers](https://docs.fyatu.com/v3/use-cases/forex-brokers.md): Accept deposits and process withdrawals for forex traders across Africa with Fyatu's collection and payout APIs.
- [Gig Platforms](https://docs.fyatu.com/v3/use-cases/gig-platforms.md): Pay drivers, freelancers, and service providers instantly with Fyatu's payout API and virtual card issuing.
- [Marketing Agencies](https://docs.fyatu.com/v3/use-cases/marketing-agencies.md): Manage ad spend budgets with Fyatu virtual cards — issue dedicated cards for Google Ads, Meta, TikTok, and programmatic campaigns.
- [Use Cases](https://docs.fyatu.com/v3/use-cases/overview.md): Discover how businesses use Fyatu's card issuing API and payment infrastructure to power fintech products across Africa.
- [SaaS Companies](https://docs.fyatu.com/v3/use-cases/saas.md): Accept subscription payments from African customers for your SaaS product with Fyatu's payment collection API.
- [Travel & Hospitality](https://docs.fyatu.com/v3/use-cases/travel.md): Process travel bookings and provide eSIMs for tourists with Fyatu's payment and eSIM APIs.
- [Get Webhook Configuration](https://docs.fyatu.com/v3/webhooks/get.md): Retrieve your current webhook configuration — endpoint URL, enabled events, and signing secret status. GET /webhooks.
- [Regenerate Webhook Secret](https://docs.fyatu.com/v3/webhooks/regenerate-secret.md): Generate a new HMAC-SHA256 webhook signing secret. Previous secret is immediately invalidated. POST /webhooks/regenerate-secret.
- [Webhook Signature Verification](https://docs.fyatu.com/v3/webhooks/signature-verification.md): How to verify that webhook events are genuinely from Fyatu using HMAC-SHA256 signatures. Examples in Node.js, PHP, Python, Go, Ruby, Java, and C#.
- [Test Webhook](https://docs.fyatu.com/v3/webhooks/test.md): Send a test webhook event to verify your endpoint is receiving and processing notifications correctly. POST /webhooks/test.
- [Update Webhook URL](https://docs.fyatu.com/v3/webhooks/update.md): Set or update your webhook endpoint URL for receiving real-time event notifications. PUT /webhooks.
- [Card 3DS OTP](https://docs.fyatu.com/v3/webhooks/webhook-events/card-3ds-otp.md): Sent when a 3DS authentication code is generated during an online purchase. Forward this code to the cardholder immediately.
- [Card Created](https://docs.fyatu.com/v3/webhooks/webhook-events/card-created.md): Sent when a new virtual card is issued to a cardholder.
- [Card Delete Warning](https://docs.fyatu.com/v3/webhooks/webhook-events/card-delete-warning.md): Sent when a card is scheduled for deletion due to inactivity. A transaction will prevent deletion.
- [Card Creation Failed](https://docs.fyatu.com/v3/webhooks/webhook-events/card-failed.md): Sent when a card issuance request fails.
- [Card Frozen](https://docs.fyatu.com/v3/webhooks/webhook-events/card-frozen.md): Sent when a card is frozen.
- [Card Funded](https://docs.fyatu.com/v3/webhooks/webhook-events/card-funded.md): Sent when funds are successfully added to a card.
- [Card Funding Failed](https://docs.fyatu.com/v3/webhooks/webhook-events/card-funding-failed.md): Sent when a card funding attempt fails. No funds are deducted — any held amount is released automatically.
- [Card Maintenance Fee Paid](https://docs.fyatu.com/v3/webhooks/webhook-events/card-maintenance-fee-paid.md): Sent when the monthly card maintenance fee is automatically debited from a card.
- [Card Negative Balance](https://docs.fyatu.com/v3/webhooks/webhook-events/card-negative-balance.md): Sent when a card's balance drops below zero.
- [Card Replaced](https://docs.fyatu.com/v3/webhooks/webhook-events/card-replaced.md): Sent when a card is replaced with a new card. The cardId stays the same.
- [Card Terminated](https://docs.fyatu.com/v3/webhooks/webhook-events/card-terminated.md): Sent when a card is permanently terminated. Any remaining balance is refunded to the business wallet.
- [Card Tokenization OTP](https://docs.fyatu.com/v3/webhooks/webhook-events/card-tokenization-otp.md): Sent when a tokenization OTP is generated for adding a card to a digital wallet (Apple Pay, Google Pay, etc.). Display this code to the cardholder immediately.
- [Card Transaction Approved](https://docs.fyatu.com/v3/webhooks/webhook-events/card-transaction-approved.md): Sent when a card purchase is approved.
- [Card Transaction Declined](https://docs.fyatu.com/v3/webhooks/webhook-events/card-transaction-declined.md): Sent when a card purchase is declined.
- [Card Transaction Reversed](https://docs.fyatu.com/v3/webhooks/webhook-events/card-transaction-reversed.md): Sent when a card transaction is reversed (refunded) by the merchant.
- [Card Unfrozen](https://docs.fyatu.com/v3/webhooks/webhook-events/card-unfrozen.md): Sent when a frozen card is unfrozen and becomes active again.
- [Card Unloaded](https://docs.fyatu.com/v3/webhooks/webhook-events/card-unloaded.md): Sent when funds are withdrawn from a card.
- [Card Unloading Failed](https://docs.fyatu.com/v3/webhooks/webhook-events/card-unloading-failed.md): Sent when a card unloading attempt fails. The card balance remains unchanged.
- [Cardholder Created](https://docs.fyatu.com/v3/webhooks/webhook-events/cardholder-created.md): Sent when a new cardholder is created in your app.
- [Cardholder KYC Approved](https://docs.fyatu.com/v3/webhooks/webhook-events/cardholder-kyc-approved.md): Sent when a cardholder's KYC verification is approved.
- [Cardholder KYC Rejected](https://docs.fyatu.com/v3/webhooks/webhook-events/cardholder-kyc-rejected.md): Sent when a cardholder's KYC verification is rejected.
- [Cardholder KYC Submitted](https://docs.fyatu.com/v3/webhooks/webhook-events/cardholder-kyc-submitted.md): Sent when a cardholder submits KYC documents for verification.
- [Collection Expired](https://docs.fyatu.com/v3/webhooks/webhook-events/collection-expired.md): Sent when a collection expires without payment.
- [Collection Failed](https://docs.fyatu.com/v3/webhooks/webhook-events/collection-failed.md): Sent when a collection fails to process.
- [Collection Initiated](https://docs.fyatu.com/v3/webhooks/webhook-events/collection-initiated.md): Sent when a new payment collection is created.
- [Collection Received](https://docs.fyatu.com/v3/webhooks/webhook-events/collection-received.md): Sent when a payment is successfully received.
- [Payout Completed](https://docs.fyatu.com/v3/webhooks/webhook-events/payout-completed.md): Sent when a payout is successfully sent.
- [Payout Failed](https://docs.fyatu.com/v3/webhooks/webhook-events/payout-failed.md): Sent when a payout fails.
- [Payout Initiated](https://docs.fyatu.com/v3/webhooks/webhook-events/payout-initiated.md): Sent when a payout request is created.
- [Refund Completed](https://docs.fyatu.com/v3/webhooks/webhook-events/refund-completed.md): Sent when a refund is successfully processed.
- [Refund Failed](https://docs.fyatu.com/v3/webhooks/webhook-events/refund-failed.md): Sent when a refund fails.
- [Refund Initiated](https://docs.fyatu.com/v3/webhooks/webhook-events/refund-initiated.md): Sent when a refund request is created.

## OpenAPI Specs

- [openapi](https://docs.fyatu.com/v3/openapi.json)

## Optional

- [Website](https://fyatu.com)