Create Card

Issue a card for a tenant customer

Create a card for a customer under your tenant.

HTTP Request

POST /api/v1/cards

Request Body

{
  "customer_id": "8dca347a-3b14-4d1a-a5c4-35c8b07d52ab",
  "card_type": "virtual",
  "provider": "auto",
  "currency": "NGN",
  "single_use": false,
  "geofence_enabled": false,
  "geofence_max_distance_km": 250
}

Supported Fields

• customer_id required
• card_type optional, defaults to virtual
• provider optional, defaults to auto
• currency optional, defaults to NGN
• single_use optional, defaults to false
• geofence_enabled optional, defaults to false
• geofence_max_distance_km optional

Response

Returns the issued card record as currently exposed by the card issuing service.

Notes

• type is accepted as an alias for card_type.
• customerId is accepted as an alias for customer_id.
• Network-brand selection fields such as brand, plus fields like funding_amount and spending_limits, are not part of the current backing service contract for this endpoint.