List Program Products

Overview

Returns all card products defined within a card program. A Card Product encapsulates all settings for cards of a specific type — brand, currency, spending limits, 3DS, tokenization, and JIT controls. Use this endpoint to discover available productId values for use with POST /cards.

Path Parameters

Parameter	Type	Description
`programId`	string	The card program ID

Success Response (200)

{
  "success": true,
  "status": 200,
  "message": "Products retrieved",
  "data": [
    {
      "productId": "PRDX1Y2Z3A4B5C",
      "programId": "prg_01HXYZ9876ABCDEF0000",
      "name":      "Visa USD Standard",
      "scheme":    "VISA",
      "cardType":  "VIRTUAL",
      "binCode":   "489301",
      "features": {
        "has3DS":          true,
        "hasApplePay":     true,
        "hasGooglePay":    true,
        "hasJIT":          false,
        "hasSpendControl": true,
        "hasMccControl":   false
      },
      "controls": {
        "isReloadable":          true,
        "isOneTimeUse":          false,
        "cardTTLMonths":         36,
        "maxCardsPerCardholder": 5,
        "spendingLimit":         1000.00,
        "spendingPeriod":        "TRANSAMOUNT"
      },
      "status":    "ACTIVE",
      "createdAt": "2026-01-12T09:00:00Z"
    }
  ],
  "pagination": {
    "total":   1,
    "limit":   50,
    "offset":  0,
    "hasMore": false
  },
  "meta": {
    "requestId": "req_01HXY123456ABCDEF",
    "platform":  "Fyatu CaaS",
    "timestamp": "2026-05-22T15:00:00Z"
  }
}

Response Fields

Field	Type	Description
`productId`	string	Unique product identifier — use this when creating cards
`programId`	string	The program this product belongs to
`name`	string	Product name (e.g. “Visa USD Standard”)
`scheme`	string	Card network: `VISA` or `MASTERCARD`
`cardType`	string	Card type (e.g. `VIRTUAL`)
`binCode`	string \| null	The registry BIN this product issues from; `null` for products created before BINs were selectable
`features.has3DS`	boolean	3D Secure is enabled
`features.hasApplePay`	boolean	Apple Pay tokenization is enabled
`features.hasGooglePay`	boolean	Google Pay tokenization is enabled
`features.hasJIT`	boolean	Just-In-Time funding is enabled
`features.hasSpendControl`	boolean	Per-card spend limits are enabled
`features.hasMccControl`	boolean	MCC allow/block rules are enabled
`controls.isReloadable`	boolean	Cards can be reloaded after issuance
`controls.isOneTimeUse`	boolean	Card auto-terminates after its first settled charge
`controls.cardTTLMonths`	integer \| null	Card lifetime in months
`controls.maxCardsPerCardholder`	integer \| null	Maximum cards a single cardholder may hold under this product
`controls.spendingLimit`	number	Spending limit in USD (flat dollar value)
`controls.spendingPeriod`	string	Window the limit applies over: `TRANSAMOUNT`, `DAILY`, `WEEKLY`, or `MONTHLY`
`status`	string	`ACTIVE` or `ARCHIVED`
`createdAt`	string	ISO 8601 timestamp when the product was created

Using Product IDs for Card Issuance

Once you have the productId, pass it directly to POST /cards:

{
  "cardholderId": "CH-ABC123",
  "nameOnCard": "JOHN SMITH",
  "amount": 100.00,
  "productId": "PRDX1Y2Z3A4B5C"
}

The API resolves all card settings (scheme, currency, limits, 3DS) from the product automatically.

Product Limits

Each program supports a maximum of 5 card products. Products with active cards issued cannot be deleted — this protects card data integrity.

Feature flags (features.has3DS, features.hasApplePay, features.hasGooglePay, features.hasJIT) become immutable once any cards have been issued under a product. These settings are baked into the card at the provider level.

Error Codes

Code	HTTP	Cause
`PROGRAM_NOT_FOUND`	404	Program not found or belongs to another business/environment
`INSUFFICIENT_SCOPE`	403	Key lacks `accounts:read` scope

Getting Started

Cardholders

Cards

Overview

Path Parameters

Success Response (200)

Response Fields

Using Product IDs for Card Issuance

Product Limits

Error Codes

​Overview

​Path Parameters

​Success Response (200)

​Response Fields

​Using Product IDs for Card Issuance

​Product Limits

​Error Codes

Overview

Path Parameters

Success Response (200)

Response Fields

Using Product IDs for Card Issuance

Product Limits

Error Codes