Skip to main content

​
Create Card

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.