Create Card

virtual card creation endpoint

POST https://vcard.fuspay.finance/api/v1/User/CreateCard

Only users that have had their KYC approved can create cards

While creating a card their merchant wallet will be debited 5$ and the card created will be automatically funded with 3$ (effective card creation fee is $2)

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	URL image file of user
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 body

200: Ok

{
    "success": true,
    "message": "Card created successfully",
    "data": {
        "card_id": "ad91437e-e159-49de-8950-88d9a000000d",
        "card_name": "ZechUser Test Card",
        "merchant_id": "1737458000000_intra_merchant_900000",
        "user_id": "66bded7c0aed0789f23729f0129",
        "tag": "personalBusiness",
        "wallet": {
            "usdt": {
                "balance": 0,
                "address": "n/a",
                "message": "fetch card details to get wallet address and card balance"
            }
        }
    }
}

Second Tab

The complete card details is not immediately returned; however, you can go to the fetch cards endpoint and use the card ID to get the complete card that details Please wait about 20seconds before fetching the complete card details using the "Get Card Details" endpoint.