Skip to main content
POST
/
cards
/
virtual-cards
/
{cardId}
/
virtual-balance
/
subtract
curl -X POST "https://api.cryptomate.me/cards/virtual-cards/card_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23/virtual-balance/subtract" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "x-idempotency-key: 4f5b8c9d-1e2a-4b3c-9d8e-7f6a5b4c3d2e" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00
  }'

150.00
Subtracts a delta amount from the virtual balance of a card, and returns the resulting balance in USD. Unlike Override virtual balance, which sets an absolute value, this endpoint applies a relative change. The operation is idempotent: retrying a request with the same x-idempotency-key returns the original result instead of applying the amount a second time. The card must hold enough virtual balance, otherwise the request is rejected. Requires an API key with access level 2 or higher.

​
Path parameters

​
cardId
string
required
Card identifier.

​
Headers

​
x-idempotency-key
string
required
Unique key that makes the operation safe to retry. Reusing the same key returns the original result without applying the amount again. Requests with a missing or blank key are rejected.

​
Body

​
amount
number
required
Amount to subtract, in USD. Must be greater than 0, with up to 2 decimal places.

​
Response

Returns the new total card balance in USD as a JSON number. 
curl -X POST "https://api.cryptomate.me/cards/virtual-cards/card_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23/virtual-balance/subtract" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "x-idempotency-key: 4f5b8c9d-1e2a-4b3c-9d8e-7f6a5b4c3d2e" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00
  }'

150.00