Creating Cards

Learn how to create physical and virtual cards via the Sudo Dashboard or API.

1. Create a cardholder

A cardholder is either an individual or business entity that can be issued a payment card. To get started, create a cardholder with a name, billingAddress, and type.

You can include additional information like KYC details, phone number, and email address.

curl --location --request POST '' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic ••••••••••••••••••••••••••••••••••••CREE1M0EwQjgyMjI0NUE3QUM=' \
--data-raw '{
	"type": "individual",
	"name": "John Doe",
	"status": "active",
	"individual": {
		"firstName": "John",
		"lastName": "Doe"
	"billingAddress": {
		"line1": "4 Barnawa Close",
		"line2": "Off Challawa Crescent",
		"city": "Barnawa",
		"state": "Kaduna",
		"country": "NG",
		"postalCode": "800001"

A call to the cardholder's endpoint returns information about the cardholder that can be subsequently used to create a card.

2. Create a card for a cardholder

Create a card and assign it to a cardholder. This request requires the cardholder ID from the previous step, type, card number (if a physical card), currency, and status. More parameters might be required as per your requirements.

curl --location --request POST '' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ••••••••••••••••••••••••••••••••••••CREE1M0EwQjgyMjI0NUE3QUM' \
--data-raw '{
	"customerId": "5f8b75ef12a06df84bd7aa3a",
	"type": "physical",
	"number": "5061000001743021565",
	"currency": "NGN",
	"status": "active"

A call to the card's endpoint returns information about the card being mapped.


Card Data Security

In order to maintain PCI Compliance and high card data security, all requests to map or retrieve card details must be passed through the vault endpoint.