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’s currency is derived from the funding source at issue time. If the account does not qualify, Grid rejects the request with 400 FUNDING_SOURCE_INELIGIBLE.

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 be denominated in the card’s currency. The response returns the updated Card resource. Changing fundingSource 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	`FUNDING_SOURCE_INELIGIBLE`	The account does not belong to the customer or is not denominated in a card-eligible currency at creation or the card’s currency when replaced.
400	`INVALID_INPUT`	`fundingSource` was 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