Cards

Gravv lets you instantly issue virtual payment cards, each powered by stablecoin balances. Gravv-issued cards are linked directly to a single account.

📘 Do I create a card directly, like an account?

No. Unlike accounts, a card can't be created directly. Every card needs an approved card application first, and in production you create that application by activating the card feature, not by calling Create card. The flow below walks through it, and Create a card application covers the application step in detail.

Card workflow

To issue and manage cards with Gravv:

1. Create a Card Account on your Dashboard. In the Sandbox environment, select Ethereum as the blockchain network backing the account. In the Live environment, select Polygon.

📘 Note

This is a one-time setup that backs the cards you create for your customers. Use an account and network supported by the card feature requirements returned for your customer; your configured card program determines the available options.

2. Save the account ID in your environment variables.

📘 Note

You'll pass this account ID as account_id in provider_data when you activate the card feature in step 6. If you leave it out, Gravv uses your tenant's card account.

3. Create a customer to obtain a customer id.
4. Complete intermediate Know Your Customer (KYC) verification. Intermediate KYC includes a selfie (liveness) check, which cards require.
5. Check the customer's eligibility for the card feature using the Check feature eligibility endpoint with feature_id virtual_cards.
6. If the customer is eligible, activate the card feature using the Activate feature endpoint. Activating virtual_cards creates the card application and returns its application_id. If the customer still needs a liveness check, the response returns a websdk_url. See Create a card application.
7. Wait to receive the application status via webhook, or check it using the Get card application endpoint. For card webhook responses, see Card events.
8. Once the application status is approved, create the card.
9. Retrieve the card details to share with your customer.
10. Fund the card using the Transfer endpoint. For more on funding, see Fund cards.
11. 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