Fund cards

You can fund customers' cards from either internal accounts or wallets using the Transfer endpoint.

Fund from an internal account

To fund a card from an internal account, include the source account id, destination card id, and customer id in your request.

The source object contains the funding account details, and the destination object contains the card details:

curl --request POST \
     --url https://api.gravv.xyz/v1/transfer \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: 979879887678789_attempt_1' \
     --header 'content-type: application/json' \
     --data '
{
  "source": {
    "source_type": "internal_account",
    "id": "b9c2cb0d-e09a-496f-8655-d8c4b7aaf2f8"
  },
  "destination": {
    "destination_type": "card",
    "id": "3397bab8-0f2b-4721-b15b-8c71860f01f9"
  },
  "amount": 6,
  "description": "Testing Card Funding",
  "customer_id": "bb6c6022-f1d8-492f-80f0-7547134bb42f",
  "client_reference": "card_funding_001"
}
'

Fund from a wallet

To fund a card from a wallet, use the Transfer endpoint with internal_crypto_wallet as the source type. Include the wallet id, crypto asset type, destination card id, and customer id in your request.

The source object contains the funding account details, and the destination object contains the card details:

curl --request POST \
     --url https://api.gravv.xyz/v1/transfer \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: 979879887678789_attempt_1' \
     --header 'content-type: application/json' \
     --data '
{
  "source": {
    "source_type": "internal_crypto_wallet",
    "id": "67e169c0-547f-410d-8e18-f616b6822d70",
    "crypto_asset": "USDC"
  },
  "destination": {
    "destination_type": "card",
    "id": "3397bab8-0f2b-4721-b15b-8c71860f01f9"
  },
  "amount": 6,
  "description": "Testing Card Funding",
  "customer_id": "bb6c6022-f1d8-492f-80f0-7547134bb42f",
  "client_reference": "card_funding_002"
}
'