Last Updated: 1/4/2022, 4:56:23 AM

# Currency

# Overview

The AccelByte Admin Portal allows you to configure the currencies you want to accept for transactions. You can configure both real-world and virtual currencies to allow your players to transact using those currencies.

# Permissions

Permissions are used to grant access to specific resources within our services. Make sure your account has the following permissions before you attempt to manage currency in the Admin Portal. For a full list of permissions that impact currency management, see the Platform/Commerce tab of the permissions reference (opens new window).

Usage Permission Tag Action
Create a Currency ADMIN:NAMESPACE:{namespace}:CURRENCY Create

Permissions work slightly differently depending on whether they are assigned to IAM Clients or Roles assigned to users. For more information, read the Authentication and Authorization documentation.

# Managing Currencies in the Admin Portal

# Create a Currency

Creating a currency in the Admin Portal will make that currency available to your players for transactions. To create a new currency, follow the steps below:

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

    currency

  2. On the Currencies page, click Add to add a new currency

    currency

  3. 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 unique identifying code for the currency in the Currency Code field. For real currencies, follow ISO_4217 standardization, such as USD for United States Dollar. For virtual currencies, you can create your own code.
    • Input the symbol associated with the currency in the Currency Symbol field, such as $. To input a symbol that isn’t on your keyboard, input the Unicode for that symbol. For virtual currencies, you can input any character combination you like, up to 8 characters.

    currency

  4. When you’re done, click Add. Your new currency will be added to the list.

    currency

# Implementing Currencies using SDK

Our SDK can also be used to allow game clients to retrieve information about the currencies you’ve configured in the Admin Portal.

# Retrieve the List of Supported Currencies

You can use the following code to retrieve the list of currencies supported by a namespace, by inputting that namespace at the top of the code where it says MyNamespace.

  • Read the Catalog documentation to learn more about how to set up your in-game or online store.