βπ³ Create a Card
Enpoint POST https://api.xixapay.com/api/card/create
π Request Headers
{
"Authorization": "Bearer YOUR_API_SECRET",
"Content-Type": "application/json",
"api-key": "YOUR_API_KEY"
}
π¦ Request Body
Field
Type
Required
Description
customer_id
string
β
Must exist in your customers
table (customer_id
column).
businessId
string
β
Your registered business ID (max 255 characters).
country
string
β
Must be either "NG"
or "US"
.
amount
number
β
Must meet the minimum amount for the selected country.
π‘ Minimum Amounts
NG
: e.g. β¦0 NGN
US
: e.g. $3 USD (Enforced dynamically by your backend using country-specific logic.)
Example
{
"customer_id": "cus_123456",
"businessId": "xixapay_7890",
"country": "US",
"amount": 10.00
}
β Success Response:
{
"status": "success",
"message": "NGN card created",
"data": {
"card_id": "31e8fb3eccdadd381ec5a43995ef11ebfb7ab9a8",
"card_number": "507874******9520",
"expiry": "08/28",
"cvv": "455",
"balance": 0,
"currency": "NGN"
}
}
Last updated