DocumentationAPI ReferencesSupportBlogAsk AI
API References

Create a Virtual Card

post
https://api.ravepay.co/v2/services/virtualcards/new

This describes how to create a virtual card on Rave.

🚧

Important notes

  • This service is not publicly available, kindly contact support ([email protected]) for it.
  • On test mode, the same (default) address is returned for all virtual cards, regardless of the address in the payload. You don't need to bother about that though. 😊

📘

Getting OTPs for MasterCard virtual cards

Due to recent changes in cards issued, We recommend passing a callback URL in your request to create cards. OTPs would be sent as webhooks to the callbacks URL. Once received, you should share this with your customer to enable them to complete their online transactions.

Body Params
string
required
Defaults to FLWSECK_TEST-SANDBOXDEMOKEY-X

This is your secret key

string
required
Defaults to USD

This is the currency the card would be denominated in, possible values are NGN and USD

string
Defaults to NGN

Use this if you want to debit a different balance on Flutterwave to fund your card e.g. you are funding a USD card but you want to debit your NGN balance to fund the card

string
required
Defaults to 5000

This is the amount to prefund the card with on card creation.

string
required
Defaults to Jermane Graham

This is the Name on the card.

string
Defaults to 333 Freemont Road

This is the registered address for the card. e.g. Your house address where you would receive your card statements.

string
Defaults to San Francisco

This is the City / District / Suburb / Town / Village registered for the card.

string
Defaults to CA

This is the State / County / Province / Region. It is a two letter word representing the state in the billing country e.g CA, NY

int32
Defaults to 984105

ZIP or postal code.

string
Defaults to US

Billing address country code, if provided. (e.g. "NG", "US")

string
Defaults to https://your-callback-url

This is a callback endpoint you provide where we send actions that happen on a card such as a transaction charge.

Responses

Updated about 4 years ago

Language
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated about 4 years ago