[POST]
{{baseUrl}}/api/v1/card/virtual/create
HeaderTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Body Parameters

ParameterTypeDescription
first_name requiredstringFirst name of card holder
last_name requiredstringFirst name of card holder
phone requiredstringPhone number
email requiredstringEmail address
address_street requiredstringAddress Street
address_city requiredstringAddress City
address_zipcode requiredstringAddress Zipcode
address_state requiredstringAddress State
bvn requiredstringBank Verification Number
id_number requiredstringIdentity Number
card_type requiredstringCard type E.g MasterCard, Verve
wallet_id optionalstringNGN Wallet ID of existing wallet

Sample response

Response
{
    "entity": {
        "card_id": "2fd7d0ba-4d70-4276-aa1e-3d67b295e96b",
        "first_name": "John",
        "last_name": "Doe",
        "email": "test@doe.com",
        "phone": null,
        "address_street": null,
        "address_city": "Address City",
        "address_country": null,
        "address_zipcode": "234",
        "reason": "",
        "dob": null,
        "category": null,
        "status": "Card - Active",
        "wallet_info": {
            "account_number": "5270519730",
            "bank_name": "DOT MFB",
            "wallet_id": "0fe81e32-6402-4cab-a5c9-a77726fc7fe6",
            "amount": 500
        },
        "card_name": "",
        "expiry_date": "2027-11-20T00:00:00",
        "last_four_digits": "4910",
        "date_created": "2024-11-20T10:16:24.948481",
        "date_updated": "2024-11-20T10:16:24.953815"
    }
}