Skip to content

Cards

Gravv lets you instantly issue virtual payment cards. All issued cards are linked directly to a single account.

Card workflow

To issue and manage cards with Gravv:

  1. Create a Card Account on your Dashboard.

This is a one-time setup, and it's meant to back all the cards you will be creating for your customers. The bank selected in the creating form must be Lead Bank.

  1. Save the account ID in your environment variables.

Include this account ID in all the card application request you will be sending through the Create card application endpoint.

  1. Create a customer to obtain a customer id.
  2. Complete the Know Your Customer (KYC) verification.
  3. Check the customer's eligibility for the card feature using the Check feature eligibility endpoint.
  4. If the customer is eligible, activate the card feature using the Activate a feature endpoint.
  5. Submit a card application using the Card Account ID you saved in step 2 and the Create card application endpoint.
  6. Wait to receive the application status via webhook, or check the status using the Get card application endpoint. For more information on card webhook responses, see Card events.
  7. Create card once the application is approved.
  8. Retrieve the card details to share with your customer.
  9. Fund the card by using the Transfer endpoint. For more information on funding issued, see Fund cards cards.
  10. Withdraw funds from the card when needed.

Using cards

Once you create a card for your customer, they can use it immediately for online transactions.

To use the card, enter the card details at checkout:

  • Card number
  • Expiry date
  • CVV
  • Billing address

For more information on all card endpoints, see Cards.