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.

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": {{ ofofonobs@gmail.com  }},
		"brand": {{ visa  }},
		"currency": {{ NGN  }},
		"maskedPan": {{ 2362*******2523  }},
		"last4": {{ 2523  }},
		"reference": {{ djdgg52vdgud7v  }},
	}
}

Last updated