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.

The Cards section of the CaaS Portal shows every card issued under your programs. Cards are created programmatically via the V3.20 API — the portal provides visibility, filtering, and manual operations for oversight and support.

Card List

Navigate to Cards in the portal sidebar to see all cards for the active environment. Filter by:
FilterOptions
StatusACTIVE, FROZEN, TERMINATED, EXPIRED
Card TypeVIRTUAL, PHYSICAL
ProgramFilter to a specific card program
CardholderFilter to cards belonging to a specific cardholder
SearchLast 4 digits or masked PAN

Card Detail

Click a card to see its full detail view:
  • PAN — masked card number (e.g. 4000 **** **** 1234)
  • Expiry — card expiry date
  • Brand — Visa or Mastercard
  • Status — current card status
  • Balance — current card balance
  • Spending Limit — card-level spending limit (if overridden)
  • Cardholder — linked cardholder identity
  • Program — the card program this card belongs to
  • Transaction History — all authorizations, clearings, declines, and reversals

Card Status

StatusDescription
ActiveCard is operational and accepting transactions
FrozenCard is temporarily blocked — no new transactions processed
TerminatedCard is permanently closed — irreversible
ExpiredCard has passed its expiry date

Card Operations

Freeze & Unfreeze

Freezing temporarily blocks all new transactions on a card without terminating it. The card can be unfrozen at any time to resume normal operation. Use cases: Lost card report, suspicious activity, cardholder request.

Fund & Unload

OperationDescription
FundTransfer USD from your program balance to the card. The cardholder can then spend up to the funded amount.
UnloadReturn USD from the card back to the program balance.
Card funding and unloading is reflected immediately in the card balance and generates a ledger transaction in your program account.

Terminate

Permanently closes the card. Any remaining balance is automatically unloaded back to the program balance before the card is terminated.
Card termination is irreversible. Once terminated, a card cannot be reactivated. A replacement card must be issued if needed.

Transactions

Each card’s detail view includes a full transaction history:
FieldDescription
TypeAUTHORIZATION, CLEARING, REVERSAL, DECLINE, FEE
AmountTransaction amount (billing currency)
MerchantMerchant name
StatusAUTHORIZED, SETTLED, REVERSED, DECLINED
DateAuthorization or settlement timestamp
Transaction events are also delivered in real time via webhooks. See Card Events for the full event reference.