v1
latestOpenAPI 3.1.02026-07-26490367.2 KBCreate Card
Create, map or replace cards for a specific customer.
Request body
The customer _id.
The funding source _id. Required if you wish to map card to an existing funding source.
The card type.
The card brand.
The card PAN (Verve or AfriGo) or Card ID (Visa). Required if type is physical.
Enable 2FA for the card, this enables the card to receive OTP for web and mobile transactions.
The currency type.
3 Digits Issuer Country. NGA for Nigeria and USA for United States. Defaults to NGA.
The initial card status.
The metadata object to attach to the card. Stored in key-value pair
The bank code of existing account. Required if you wish to map card to existing account.
The account number of existing account. Required if you wish to map card to existing account.
The _id of the current card you wish to replace. Required for card replacement.
The reason for replacement. Required for card replacement.
Debit account _id. Required for all virtual cards and giftcards.
Funding amount. Required for mastercard.
Send default PIN to customer phone number via SMS.
Card expiry date. Applies to Visa cards only. Format MMM-YYYY example AUG-2025. All cards are subject to maximum of 3 years validity.
Response
Card created successfully.
Status code of the response. 200 indicates a successful request.
Human-readable description of the result.