Method DecrementBalanceAsync
DecrementBalanceAsync(string, int, DecrementBalanceOptions)
Decrements the balance of the specified currency for the currently logged in user.
This method optionally takes a writeLock string. If provided, then an exception will be thrown unless the writeLock matches the writeLock received by a previous read, in order to provide optimistic concurrency. If not provided, the transaction will proceed regardless of any existing writeLock in the data. Throws a EconomyException with a reason code and explanation if the request is badly formed, unauthorized or uses a missing resource.
Declaration
Task<PlayerBalance> DecrementBalanceAsync(string currencyId, int amount, DecrementBalanceOptions options = null)
Parameters
| Type | Name | Description |
|---|---|---|
| string | currencyId | The currency ID to update |
| int | amount | The amount to decrement by |
| DecrementBalanceOptions | options | (Optional) Use to set a write lock for optimistic concurrency |
Returns
| Type | Description |
|---|---|
| Task<PlayerBalance> | The updated player balance for the relevant currency. |
Exceptions
| Type | Condition |
|---|---|
| EconomyException | Thrown if request is unsuccessful |
| EconomyValidationException | Thrown if the service returned validation error. |
| EconomyRateLimitedException | Thrown if the service returned rate limited error. |