Cards
Issue USD Visa cards to verified customers, and learn how the card account, card KYC, activation, funding, limits and status work.
This page explains how Gravv cards work and what you need before you issue one. Gravv issues USD Visa cards, virtual or physical, to customers you have verified. Each card spends from its own balance, which you top up with a transfer from an account or a wallet. You set a daily spending limit, and you can freeze, unfreeze or block a card at any time.
A money example. Ada uses your app. You issue her a virtual card with a daily limit of 300 USD. Its balance is 0. You move 150 USD from her USD account to the card. She pays 18.75 USD for a streaming subscription, and the card holds 131.25 USD.
What you need first
- Your card account. One account of type
cardbacks every card your business issues. You open it once. See Set up your card account. - A verified cardholder. The customer's
basicKYC iscompleted, with a liveness (selfie) check. See Card KYC and activation.
How a card is issued
| Step | Call | Sandbox | Live |
|---|---|---|---|
| 1. Check what is missing | Check feature eligibility | Same | Same |
| 2. Activate cards for the customer | Activate feature with virtual_cards and your card account's id as account_id |
Gravv approves the application at once and issues a virtual card during this call | Gravv submits the card application |
| 3. Find the card or application | GET /v1/cards?customer_id=… |
The list shows the card with status active |
The list shows an application row with status "" until a card exists |
| 4. Wait for approval | GET /v1/cards/applications (application_status) or the cards.application.update webhook |
Skip | Wait for approved |
| 5. Issue the card | Create a card | Skip, unless you want a second card | Create it once, after approval |
The activation response contains no application id. Gravv sends no webhook when it issues a card. Read the card with Get card.
Running a card
| Task | Page |
|---|---|
| Put money on it | Fund cards |
| See what it can spend | Check card balance |
| Change its daily limit, freeze, unfreeze or block it | Manage card status. Send limit on every update |
| Show the number, CVV or PIN, or set a PIN | View card sensitive details, Manage card PIN |
| Work out why a payment was declined | Card decline reasons |
| Take money off a card | Withdraw from card. Not yet available for new cards |
Availability
| What | Status |
|---|---|
| Virtual cards for individuals | Available |
| Several cards per person (up to 10), shared or own balance | Available |
| Physical cards | Not yet available. See Physical card shipping |
| Business cards printed with the company name | Sandbox only. Not yet available in live |
| Withdrawing from a new card | Not yet available |
| Decline reasons through the API | Not yet available |
| Card currency other than USD | Not supported |
Always send limit when you update a card. An update without it sets the card's daily limit to 0. In live, Gravv then declines every payment. In sandbox, the card loses its limit.
Using a card
The cardholder can use a virtual card for online payments as soon as it is active and funded. The cardholder enters the card number, expiry date and CVV at checkout, which your app shows them through sensitive details.
For step-by-step guides, see the card recipes.