Create Virtual Card

Creates a new USD-denominated virtual card for the authenticated business user. The card can be used for online transactions such as subscriptions, shopping, or services that accept USD cards.

In a nutshell

Card creation is only available to business accounts that have been granted access to USD card features.

Creates a new USD-denominated virtual card for the authenticated business user. The card can be used for online transactions such as subscriptions, shopping, or services that accept USD cards. Upon creation, the card is immediately funded with the specified amount and linked to the user's business account.

Before using this endpoint, ensure the business account has enough wallet balance in NGN to cover the exchange rate and applicable fees. The exchange rate is dynamically fetched from the Sudo API, and all transactions are logged and traceable through the card’s history endpoint.

Create Virtual Cards

POST {{ BASE }}/create-card

--header 'Accept: application/json'
--header 'Authorization: Bearer {{  access_token }}'

Request Body

Below are the request body parameters 🎉

Name	Type	Description
name	String	The customers full name
phone_number	Number	Customers mobile phone number in international format.
email	String	Customers Email must be a valid email address
funding	boolean	Amount in USD
cardtype	String	Card type is required (visa, mastercard).
dob	String	Customers date of birth in the format YYYY/MM/DD
address	String	Customers Address
city	String	Customers City
state	String	Customers State
postal_code	String	Customers Postal code (E.g 213200)
country	String	Customers Country

Response Body

{
	"status": true,
	"message": "Congratulations! Your card has been created successfully",
	"data": {
		"account_id": {{  gjwhsjdd836382hddg }},
		"card_id": {{ hsgd6378ehdjdjd  }},
		"name": {{  Oluwaseun Ikuesan }},
		"email": {{ [e-mail]  }},
		"brand": {{ visa  }},
		"currency": {{ NGN  }},
		"maskedPan": {{ 2362*******2523  }},
		"last4": {{ 2523  }},
		"reference": {{ djdgg52vdgud7v  }},
	}
}