Skip to main content
POST
/
virtual-cards
Create a Virtual Card
curl --request POST \
  --url https://api.flutterwave.com/v3/virtual-cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "USD",
  "amount": 5,
  "debit_currency": "NGN",
  "billing_name": "Flutterwave Developers",
  "billing_address": "333, Fremont Street",
  "billing_city": "San Francisco",
  "billing_state": "CA",
  "billing_postal_code": "94105",
  "billing_country": "US"
}
'
{
  "status": "success",
  "message": "Card created successfully",
  "data": {
    "id": "43ec6e92-9eb7-48ad-91c8-7bee425a33cf",
    "account_id": 65637,
    "amount": "20,000.00",
    "currency": "NGN",
    "card_hash": "43ec6e92-9eb7-48ad-91c8-7bee425a33cf",
    "card_pan": "5366130699778900",
    "masked_pan": "536613*******8900",
    "city": "Lekki",
    "state": "Lagos",
    "address_1": "19, Olubunmi Rotimi",
    "address_2": null,
    "zip_code": "23401",
    "cvv": "134",
    "expiration": "2023-01",
    "send_to": null,
    "bin_check_name": null,
    "card_type": "mastercard",
    "name_on_card": "Jermaine Graham",
    "created_at": "2020-01-17T18:33:29.0130255+00:00",
    "is_active": true,
    "callback_url": null
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
currency
string
required
​
amount
integer<int32>
required
​
debit_currency
string
required
​
billing_name
string
required
​
billing_address
string
required
​
billing_city
string
required
​
billing_state
string
required
​
billing_postal_code
string
required
​
billing_country
string
required

Response

200 - application/json; charset=utf-8

OK

​
status
string
required
​
message
string
required
​
data
Data43 · object
required
Example:
{
  "id": "43ec6e92-9eb7-48ad-91c8-7bee425a33cf",
  "account_id": 65637,
  "amount": "20,000.00",
  "currency": "NGN",
  "card_hash": "43ec6e92-9eb7-48ad-91c8-7bee425a33cf",
  "card_pan": "5366130699778900",
  "masked_pan": "536613*******8900",
  "city": "Lekki",
  "state": "Lagos",
  "address_1": "19, Olubunmi Rotimi",
  "address_2": null,
  "zip_code": "23401",
  "cvv": "134",
  "expiration": "2023-01",
  "send_to": null,
  "bin_check_name": null,
  "card_type": "mastercard",
  "name_on_card": "Jermaine Graham",
  "created_at": "2020-01-17T18:33:29.0130255+00:00",
  "is_active": true,
  "callback_url": null
}