Create Card
virtual card creation endpoint
https://api.switch.tulupay.com/v1/card/createCard
' POST '
Request Header
Name
Type
Description
Authorization
Bearer Token
Bearer token ${partner_secret_key}
Content-Type
Application/json
x-partner-id
xxxxxxxx
Your partner ID eg. p602xxx
Request body
Name
Type
Description
card_name*
String
The name the user intend to name the virtual card.
user_id*
String
The ID of the user for creating the virtial card.
tag*
String
the user's tag e.g school.
bvn*
String
the bank verification number of the user.
country*
String
Country name of the user.
house_no*
String
user's house number.
street*
String
The name of the street where the user resides.
state*
String
The state of residence of the user.
city*
String
The user's city
zip_code*
String
user's zip code.
id_type*
String
ID type (type of ID e.g BVN, NIN, Passport).
id_no*
String
ID number (ID number of the user's KYC document).
dob
String
The user's date of birth e.g yyyy-mm-dd.
id_image
String
An image file of the user's identification document
address
String
The full address of the user, combining.
{
"card_name": "Payment for school",
"user_id": "xxxx",
"merchant_id": "xxx",
"tag": "school",
"bvn": "123",
"country": "Nigeria",
"house_no": "12",
"street": "c",
"state": "s",
"city": "cc",
"zip_code": "234",
"id_type": "nin",
"id_no": "222",
"address": "No 6 sars road",
"dob": "yyyy-mm-dd",
"id_image": "http://ex.png"
}Response
200 - OK successful response
{
"success": true,
"message": "Card created successfully",
"data": {
"card_name": "tulupay test card",
"merchant_id": "1732010206724",
"user_id": "1732010206724",
"card_id": "1732010206724",
"tag": "school fees",
"wallet": {
"usdt": {
"balance": 0,
"address": "default-trc-20-usdt-address-xxxxx"
}
}
}
}Contact Us for Developer Support
Contact our dedicated developer support team for assistance, guidance, or any questions you have regarding Tuluswitch API integration. We're here to ensure your development experience is smooth and successful.
Read Our Developer Blog for Insights
Master the Tuluswitch API with our Developer Blog! Get expert insights, advanced tips, and industry trends beyond the documentation. Stay connected with the developer community to build exceptional payment platforms. Visit the blog now and unlock your full potential!