Skip to main content

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 v3.20

Beta — API v3.20 is currently in beta. V3 remains fully supported and will not be deprecated.
API v3.20 is the next evolution of the FYATU card issuing API. It introduces card programs, product-based card issuance, and scope-based access control — giving you full control over the card products you deliver to your users.

Quick Start

Get up and running with your first V3.20 API call

Authentication

Secure authentication with scoped access tokens

API Reference

Explore all available V3.20 endpoints

Webhooks

Real-time event notifications

​
What’s New in V3.20

V3.20 uses a single set of API credentials (businessId + secretKey) that covers all card operations. One token, one credential set.
Read your card program details via API. A Card Program defines the contractual terms (pricing, currencies, card brands) available to your business. Programs are created and configured in the FYATU Dashboard.
Cards in V3.20 are issued against a Card Product (productId). A product encapsulates all card settings — brand (Visa/Mastercard), currency, spending limits, 3DS, tokenization, and JIT controls. You define your products in the Dashboard; the API resolves all settings automatically at issuance.
V3.20 tokens carry fine-grained scopes (e.g., cards:read, cards:write, cardholders:read). Request only the scopes your integration needs. Tokens with restricted scopes reduce your attack surface.
Manage your webhook URL and signing secret directly via the V3.20 webhooks API. One webhook endpoint receives all card and cardholder events.

​
Base URL

https://api.fyatu.com/api/v3.20

​
Available Scope Sets

ScopeAccess
cards:readView cards and card transactions
cards:writeCreate, fund, freeze, unfreeze, replace, delete cards
cardholders:readView cardholders
cardholders:writeCreate, update, delete cardholders; initiate KYC
programs:readView card programs and products
account:readView wallet, transactions, pricing, statement
webhooks:readView webhook configuration
webhooks:writeUpdate webhook URL, regenerate secret, send test

​
Getting Started

1

Create Account

Sign up at web.fyatu.com/auth/register
2

Verify Your Identity (KYC)

Submit your identity documents to verify your account
3

Upgrade to Business

Upgrade your account to Business from the dashboard
4

Set Up a Card Program

Create a Card Program from your Business Dashboard. Configure card products with your desired settings (brand, currency, limits, 3DS).
5

Get Business API Credentials

Go to Business Dashboard → Developer → API Credentials to get your businessId and secretKey.

Ready to start?

Follow the quickstart guide to make your first V3.20 API call

​
Need Help?

Click the chat icon in the bottom right corner to talk to our support team.