Environment setting🔗

Setting in-app products🔗

MRGS uses the Central Bank of the Russian Federation service to convert payments to rubles. Some currencies are unavailable via the Central Bank API, and for those payments MRGS uses the USD -> RUB conversion. Fill the section with in-app products of your application and set the price in USD for the proper report creation.

• Open the MRGS website and go the in-app products editing menu.

• Add all products, which a user can purchase in your application. You can full the fields manually or import them in the CSV format.

Verification🔗

The verification on the MRGS server will ensure the reliability of the in-app payment reports and will protect you from the fraudulent schemes of receiving the in-game rewards. For the correct payment verification on the MRGS server you need to fill a few parameters in the application setting section.

iOS🔗

1. Get the key from App Store according to documentation

2. Add key to MRGS:

   • Open the MRGS website and go the application editing menu.

     

   • Copy the App-Specific Shared Secret from the clipboard to the Secret key for payment validation field.

     

   • Press the "Save" button.

Amazon🔗

Receive the Amazon Shared Key:

1) Follow the link to the Identity section. Make sure that you have logged in to the account where your project is located.
2) Copy the key to the clipboard.

3) Open the MRGS website and go the application editing menu.

4) Copy the key from the clipboard to the Secret key for verification of payment field.

5) Press the Save button.

Android🔗

• Receive the Google Play credentials:

1. Create a new Service Account🔗

Open Google Cloud console and choose your project.

Click the +CREATE SERVICE ACCOUNT button at the top of the page.

2. Configure your service account🔗

Set the Service account name. Then click create and continue.

Choose the Editor (Basic -> Editor or use a filter) and continue. Then you can skip the next step Grant users access to this service account by simply clicking done.

3. Create service key🔗

Copy a email of created service account for future use and then click on the newly created service account.

Go to the KEYS section and then click ADD KEY -> Create new key.

Download your JSON file by clicking the Create button.

Then you will see the message about private key.

4. Grant Access🔗

Open Google Play console, go to Users ans permissions section and click Invite new users.

Add copied email from step 3.

Go to the permissions section of App permissions tab and then click Add app. Select the applications you need from the list and then click Apply.

Make sure that you have the following permissions set:

• View app information (read-only)
• View financial data
• Manage orders and subscriptions.

And click the Apply button at the bottom of the page.

Send an invitation for this service account by clicking the Invite user button (it will be accepted automatically).

Confirm your intention in the dialog box that opens by clicking the Send invitation button.

5. Paste the credentials JSON to MRGS project settings🔗

• Open the MRGS website and go the application editing menu.

• Use any text editor to open the JSON file with Google Play credentials, which was received during the step 3, and copy the data to the clipboard.

• Copy the JSON from the clipboard to the JSON settings for payment validation on the server field.

• Press the Save button.

Huawei🔗

To receive a secret key to validate a payments:

1) Go to the Huawei Console website.
2) Go to the Credentials section, select your project from the drop-down list, and copy the Secret from OAuth 2.0 client IDs.
3) Select your project from the drop-down list. Make sure that you have selected exactly your application, otherwise you will take the wrong key.
4) Copy the Secret from OAuth 2.0 client IDs.

5) Open the MRGS website and go the application editing menu.

6) Copy the key from the clipboard to the Secret key for verification of payment field.

7) Press the Save button.

Samsung🔗

Payment validation does not require any Secret keys. It is enough to create the application in MRGS by specifying the Samsung platform there

Game Center MyGames🔗

• Upload JSON file with products in your application settings on the MyGames Store website

JSON example to upload:

{
   "appid":111111,
   "items":[
      {
         "itemdefid":10,
         "type":"item",
         "price":"1;USD99",
         "marketable":false,
         "tradable":false,
         "name":"Small limited offer"
      },
      {
         "itemdefid":20,
         "type":"item",
         "price":"1;USD599",
         "marketable":false,
         "tradable":false,
         "name":"Medium event offer"
      },
      {
         "itemdefid":30,
         "type":"item",
         "price":"1;USD1999",
         "marketable":false,
         "tradable":false,
         "name":"Big event offer"
      }
   ]
}

• Application owner (manager with owner rights) must generate a key to validate payments

• On the MRGS site in the settings section of your application, specify the validation key generated in the previous step

• On the MRGS site, in the in-app product settings section, create the same list of products as on the MyGames Store