Page cover image

Cards Issuance

This endpoint is used to issue a new card for a customer after creating card account for the user using the create card account endpoint.

POST {{base_url}}/business/vcard-issuance

Headers

Name
Type
Description

Authorization*

String

SECRET_KEY

Request Body

Name
Type
Description

cardbrand*

Sting

Card brand you want to issued e.g Mastercard, Visa

currency*

String

USD for USD Virtual Card or NGN for NGN Virtual card

amount*

Amount to pre-fund the card with after issuing

trackingid*

String

Customer tracking ID returned from the card account endpoint

Take a look at how you might do this:

curl --location '{{base_url}}/business/vcard-issuance' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SECRET_KEY' \
--data '{
    "currency": "USD",
    "trackingid": "9239293",
    "cardbrand": "Mastercard",
    "amount": 5
}'

Sample response

{
    "status": true,
    "responsecode": "01",
    "message": "Card Issuance Processing",
    "txref": "0621121102020",
    "charged": 6,
    "currency": "USD"
}

When the card is successfully processed, we will notify you via webhook notification with the card details and card ID. Event_type as transactions and Paid_through as virtualcard

Last updated

Was this helpful?