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.

Card Products

Every card is issued from a product — a template that defines the card’s brand, currency, spending limits, tokenization support, and available features. Use List Products to discover what’s available for your business.

Selecting a Product

Pass productId when creating a card:
POST /cards
{
  "cardholderId": "CH1a2b3c4d5e6f",
  "amount": 100.00,
  "productId": "MCUSD1"   // specific product
}
If productId is omitted, the product marked isDefault: true is used automatically.

Availability Flags

Each product exposes flags that indicate what’s currently supported:
FlagDescription
canIssueWhether new cards can be created from this product. Only canIssue: true products are accepted at card creation.
canFundWhether cards of this product can receive funding.
canUnloadWhether cards of this product support unloading (withdrawing balance).
isDefaultFallback product used during card replacement when the original product is unavailable.
Replacement fallback: when replacing a card, the system first tries to issue the same product. If that product has canIssue: false, the isDefault: true product is used instead. The card balance is transferred seamlessly regardless.

Spending Limits

Each product defines a spendingLimit and spendingPeriod that cap how much can be spent within a time window. For example, spendingLimit: 25000 with spendingPeriod: DAILY allows up to $25,000 in purchases per day. Limits apply to purchase transactions only — funding and unloading are not affected.

Multi-Currency

Cards are available in multiple currencies (USD, EUR). For non-USD cards, amount is specified in the card’s currency and your USD wallet is debited the equivalent at the current exchange rate:
Card CurrencyWallet DebitCard Balance
USDDirect (1:1)Amount in USD
EURConverted at market rateAmount in EUR

Endpoint