curl --request PATCH \
--url https://api.qbank.cl/platform/v1/cards/{cardID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"frozen": true
}'{
"card_id": "3c2b1a09-8d7e-6f5a-4b3c-2d1e0f9a8b7c",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"physical": false,
"cardholder_kind": "account",
"status": "frozen",
"spending_asset": "USDC",
"limits": {
"per_transaction": "200.000000"
},
"created_at": "2026-07-08T12:00:00Z",
"updated_at": "2026-07-08T13:00:00Z"
}Update limits, spending asset or freeze/unfreeze
Updates the card’s spending limits (send “0” to remove a limit), changes the balance it spends from (spending_asset, future purchases only) and freezes or unfreezes it. Frozen cards decline every authorization instantly.
PATCH
/
v1
/
cards
/
{cardID}
curl --request PATCH \
--url https://api.qbank.cl/platform/v1/cards/{cardID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"frozen": true
}'{
"card_id": "3c2b1a09-8d7e-6f5a-4b3c-2d1e0f9a8b7c",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"physical": false,
"cardholder_kind": "account",
"status": "frozen",
"spending_asset": "USDC",
"limits": {
"per_transaction": "200.000000"
},
"created_at": "2026-07-08T12:00:00Z",
"updated_at": "2026-07-08T13:00:00Z"
}Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Path Parameters
Body
application/json
Response
Updated card.
Available options:
account, person Available options:
pending_activation, active, frozen, cancelled Balance the card's purchases spend from. USDT/USDC 1:1 with the USD; BTC/GOLD/SILVER/PLATINUM converted at the price of the moment of each event. Changing it only affects future purchases.
Available options:
USD, USDT, USDC, BTC, GOLD, SILVER, PLATINUM Spending limits, always measured in USD regardless of the spending asset.
Show child attributes
Show child attributes