Virtual Cards
Subtract from virtual balance
Subtract a delta amount from the virtual balance of a card.
POST
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
string
required
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.