Currency

Overview

AccelByte Commerce services allow you to define what currencies you can accept for payment. Both real and virtual currencies are supported.

In the Admin Portal, you can assign different currencies to different namespaces. For example, if you have separate Game and Publisher namespaces, the Game namespace can have virtual currency assigned to it and the Publisher namespace can use real-world currency.

Tutorials

Create a Currency

You can create a currency so that you can price the items or games that you’ve created. To create a new currency, follow the steps below:

Create a Currency Using API

  1. Use the Create a Currency: POST /admin/namespaces/{namespace}/currencies endpoint.
  2. Input the Namespace field with the Publisher Namespace.
  3. Fill out the Request Body:
    • Input the Currency Code.
    • Input the Localization Description with the localized name of your currency, if needed.
    • Input the Currency Symbol.
    • Input the Currency Type. The choices are either real or virtual currency.
    • Input the Decimals if you are choosing the Real currency type.
    • Input the maximum amount per transaction in the Max. Amount/Transaction field. By default, the value is -1 for an unlimited amount.
    • Input the maximum transaction amount per day in the Max. Transaction Amount/Day field. By default, the value is -1 for an unlimited amount.
    • Input the maximum balance a player can have in the Max. Balance Amount field. By default, the value is -1 for an unlimited amount.

Create a Currency in the Admin Portal

  1. In the Publisher Namespace, go to the E-Commerce section and click the Currencies menu.

currency

  1. In the Currencies page, click Add to add a new currency

currency

  1. After the Add Currency form appears, fill out in the appropriate fields.

    • Select the Currency Type. Select Real if you want to create a real currency and Virtual if you want to create a virtual currency.
    • Input the Currency Code with a unique code that represents a country’s currency. For example USD for United States Dollar. For real currencies, follow the ISO_4217 standardization. For virtual currencies, you can create your own code
    • Input the Currency Symbol.
    • Input the maximum amount per transaction in the Max. Amount/Transaction field. By default, the value is -1 for an unlimited amount.
    • Input the maximum transaction amount per day in the Max. Transaction Amount/Day field. By default, the value is -1 for an unlimited amount.
    • Input the maximum balance a player can have in the Max. Balance Amount field. By default, the value is -1 for an unlimited amount.

    currency

  2. When you’re done, click Add and your new currency will be added to the list.

currency

What's Next

  • To learn how to implement currencies, check out the API Reference.