Funding Sources

A card’s fundingSource is the internal account that Authorization Decisioning pulls from when an authorization arrives. Every card is bound to one funding source.

At issue time

Supply fundingSource when you create the card with POST /cards:

curl -X POST "$GRID_BASE_URL/cards" \
  -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
    "form": "VIRTUAL",
    "fundingSource": "InternalAccount:019542f5-b3e7-1d02-0000-000000000002"
  }'

The internal account must:

Belong to the customer.
Be denominated in a card-eligible currency.

The card program fixes the card’s currency at issuance. USDB-funded cards transact in USD, with funding converted at 1 USDB = 1 USD. Their spending limits are in USD cents. If the account does not qualify, Grid rejects the request with 400 INVALID_INPUT. If the funding source is an EMBEDDED_WALLET account, the cardholder must also authorize a delegated signing key before the card can fund a transaction. See Embedded Wallet funding.

Replace the funding source

Supply a different fundingSource with PATCH /cards/{id} to replace the account that funds the card:

curl -X PATCH "$GRID_BASE_URL/cards/Card:019542f5-b3e7-1d02-0000-000000000010" \
  -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "fundingSource": "InternalAccount:019542f5-b3e7-1d02-0000-000000000003"
  }'

The replacement account must belong to the customer and use a currency supported by the card’s program, including USDB for USD cards. The response returns the updated Card resource. Changing fundingSource does not change the card’s currency or spending-limit units, and does not fire a webhook. You cannot supply fundingSource alongside status: CLOSED. To stop a card from spending, set status: FROZEN instead.

Errors

Status	Code	What it means
400	`INVALID_INPUT`	The account does not belong to the customer, or its currency is not supported by the card program. Also returned when `fundingSource` is supplied alongside `status: CLOSED`, or another request field is invalid.
409	`CARD_NOT_MUTABLE`	The card is `CLOSED`.

Stop a card from spending

Freeze the card without changing its funding source:

curl -X PATCH "$GRID_BASE_URL/cards/Card:019542f5-b3e7-1d02-0000-000000000010" \
  -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "status": "FROZEN" }'

To permanently retire a card, close it with PATCH /cards/{id} and status: "CLOSED".

Overview

Onboarding

Card management

Transactions

Card design

Platform tools

At issue time

Replace the funding source

Errors

Stop a card from spending

​At issue time

​Replace the funding source

​Errors

​Stop a card from spending

At issue time

Replace the funding source

Errors

Stop a card from spending