{!See https://docs.google.com/document/d/1takg_GmIBBKKTj-GHZCwzxohpQz7Bhekivkk72kYMtE/edit for reference implementation of OneTrust, dataLayer and GTM} {!OneTrust Cookies Consent} {!OneTrust Cookies Consent end} {!dataLayer initialization push} {!dataLayer initialization push end} {!Google Tag Manager} {!Google Tag Manager end} Method DecrementBalanceAsync | Economy | 3.3.0
docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    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.

    In This Article
    Back to top
    Copyright © 2023 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)