Balance
Subtract from individual card virtual balance
Subtract a delta amount from the virtual balance of an individual card.
POST
Subtracts a delta amount from the virtual balance of an individual card, and returns the resulting balance in USD. Unlike Override individual card 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
string
required
Individual card identifier.
Headers
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
number
required
Amount to subtract, in USD. Must be greater than 0, with up to 2 decimal places.