Create card
A comprehensive testing strategy is crucial to ensure the successful integration of SmartpayGenie into your application. Here are some key testing types:
Create a card
Endpoint:
https://vcard.fuspay.finance/api/v1/User/CreateCard
Method:
‘ POST ’
Only users that have had their KYC approved can create cards
Request parameters
Parameter
Authorization
Content-Type
x-partner-id
Type
Bearer Token
Application/json
xxxxxxxx
Description
Bearer token ${partner_secret_key}
-
Your partner ID eg. p602xxx
Request body
| Field 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 virtual 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. |
Request payload
JSON
{
"card_name": "Payment for school",
"user_id": "xxxx",
"merchant_id": "xxxx",
"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": "Fuspay 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"
}
}
}
}
Supports
If you encounter any issues or have questions, please feel free to contact our dedicated support team.
We are committed to providing you with the best possible experience and support.