➕💳 Create a Card

Enpoint POST https://api.xixapay.com/api/card/create

🔐 Request Header^s

{
  "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. ₦3,000 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": "Virtual card created successfully",
    "data": {
        "card": {
            "id": "a1b2c3d4e5f6",
            "number": "411111******1111",
            "expiry": "12/25",
            "cvv": "123",
            "balance": {
                "amount": 50.00,
                "currency": "USD"
            },
            "status": "active",
            "type": "virtual",
            "brand": "MasterCard",
            "spending_limit": 1000,
            "issuer_country": "USA"
        },
        "fees": {
            "funding_fee": 1.50,
            "issuance_fee": 1.00,
            "total_charged": 52.50
        },
        "timestamp": "2023-11-15 14:30:45",
        "reference": "txn_123456789"
    }
}