Create Card
Create, map or replace cards for a specific customer.
Authorizations
Body
The currency type.
NGN, USD The customer _id.
The initial card status.
active, inactive The card type.
physical, virtual The account number of existing account. Required if you wish to map card to existing account.
Funding amount. Required for mastercard.
The bank code of existing account. Required if you wish to map card to existing account.
The card brand. Required if type is virtual.
Verve, MasterCard, Visa Debit account _id. Required for all virtual cards and giftcards.
Card expiry date. Applies to Visa cards only. Format MMM-YYYY example AUG-2025. All cards are subject to maximum of 3 years validity.
The funding source _id. Required if you wish to map card to an existing funding source.
3 Digits Issuer Country. NGA for Nigeria and USA for United States. Defaults to NGA.
NGA, USA The metadata object to attach to the card. Stored in key-value pair
The card PAN (Verve) or Card ID (Visa). Required if type is physical.
The _id of the current card you wish to replace. Required for card replacement.
The reason for replacement. Required for card replacement.
lost, stolen Send default PIN to customer phone number via SMS.
Card spending controls. Default usage limits will be applied if non is provided.
Response
The response is of type object.