Перейти к содержанию

Настройка окружения🔗

Настройка in-app продуктов🔗

MRGS использует сервис Центробанка РФ для конвертации суммы платежей в рубли. Ряд валют недоступен через API ЦБ РФ и для таких платежей MRGS использует конвертацию USD -> рубли. Заполните раздел с in-app продуктами вашего приложения и укажите цену в USD для корректного формирования отчетов по платежам

  • Откройте сайт MRGS и зайдите в меню редактирования in-app продуктов

mrgs_app_settings

  • Добавьте все продукты, которые пользователь может купить в вашем приложении. Вы можете заполнить поля вручную либо импортировать их в формате CSV
Зачем заполнять таблицу с товарами

Для конвертации валют внутри платежей MRGS использует API сайта ЦБ РФ. Если, указанной в платеже, валюты нет на сайте ЦБ РФ, то MRGS возьмет цену в USD из таблицы SKU. Важно Данная информация используется только при обработке платежей на сервере. SDK MRGS на клиенте не получает этот список SKU и всегда загружает информацию по продуктам только из магазина приложений.

В случае, если пришедшего платежа нет в нашей админке и мы не смогли сконвертировать пришедшую валюту в доллары через api, то тогда в MRGS и Террабанк попадет 0. MyTracker.MyUA, 1Link собирает платежи отдельно от MRGS, через MyTracker.

Верификация🔗

Верификация на сервере MRGS обеспечит достоверность отчетов по встроенным платежам, а также защитит Вас от мошеннических схем начисления награды внутри игры.
Для корректной верификации платежей на сервере MRGS, Вам необходимо заполнить ряд параметров в разделе настройки приложения.

iOS🔗

  1. Получите ключ из App Store credentials согласно документации
  2. Добавьте полученный ключ в MRGS:

    • Откройте сайт MRGS и зайдите в меню редактирования приложения

      mrgs_ios_app_settings

    • Скопируйте App-Specific Shared Secret из буфера в поле Секретный ключ для проверки платежей

      mrgs_ios_app_credentials

    • Нажмите кнопку "Сохранить"

Amazon🔗

Получите Amazon Shared Key:

1) Перейдите по ссылке в раздел Identity. Убедитесь что зашли на аккаунт где расположен ваш проект.
2) Скопируйте ключ в буфер обмена.

amazon_credentials

3) Откройте сайт MRGS и зайдите в меню редактирования приложения.

mrgs_android_app_settings

4) Скопируйте ключ из буфера в поле Секретный ключ для проверки платежей

mrgs_amazon_app_credentials

5) Нажмите кнопку Сохранить

Android🔗

  • Получите Google Play credentials:

1. Создайте новый Service Account🔗

Отройте Google Cloud console и выберете ваш project.

Нажмите кнопку +CREATE SERVICE ACCOUNT в верхней части страницы.

google_play_console

2. Настройте Service Account🔗

Задайте имя учетной записи службы. Затем нажмите create and continue.

google_play_console

Выберите Editor (Basic -> Editor или используйте фильтр) и нажмите continue. Затем вы можете пропустить следующий шаг Grant users access to this service account просто нажав кнопку done.

google_play_console

3. Создайте Service Key🔗

Скопируйте email созданного service account, он пригодится поздней. Нажмите на созданный service account.

google_play_console

Перейдите в раздел KEYS а затем нажмите кнопку ADD KEY -> Create new key.

google_play_console

Скачайте JSON файл нажав кнопку Create.

google_play_console

Затем вы увидите сообщение о закрытом ключе.

google_play_console

4. Настройка разрешений🔗

Откройте Google Play console и перейдите в раздел Users ans permissions и нажмите Invite new users.

google_play_console

Добавьте скопированный email из п.3

google_play_console

Перейдите к разделу Permissions к вкладке App permissions а затем нажмите кнопку Add app. Выберите нужные вам приложения из списка а затем нажмите кнопку Apply.

google_play_console

Убедитесь что у вас выставлены следующие разрешения:

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

И нажмите кнопку Apply в нижней части страницы.

google_play_console

Отправьте приглашение для данного service account нажав кнопку Invite user (Оно будет принято автоматически).

google_play_console

Подтвердите свое намерение в открывшемся диалоговом окне нажав кнопку Send invitation.

google_play_console

5. Вставьте credentials JSON в настройки проекта MRGS🔗

  • Откройте сайт MRGS и зайдите в меню редактирования приложения.

mrgs_android_app_settings

  • Откройте в любом текстовом редакторе JSON файл с Google Play credentials, полученный на шаге 3, и скопируйте данные в буфер обмена.

  • Скопируйте JSON из буфера в поле JSON настройки для проверки платежей на сервере.

mrgs_ios_app_credentials

  • Нажмите кнопку Сохранить

Google Play credentials

Может пройти около 24 часов прежде чем Android Developer API заработает. Вы можете увидеть "Please provide valid JSON credentials" в течение первых 24 часов, пока учетные данные не начнут работать должным образом.

Huawei🔗

Чтобы получить Секретный ключ для проверки платежей:

1) Зайдите на сайт Huawei Console
2) Перейдите в раздел Credentials.
3) Выберите ваш проект из выпадающего списка. Убедитесь что вы выбрали именно ваше приложение, в противном случае вы возьмете неправильный ключ.
4) Скопируйте Secret из OAuth 2.0 client IDs.

notifications_huawei_settings

5) Откройте сайт MRGS и зайдите в меню редактирования приложения

mrgs_android_app_settings

6) Скопируйте ключ из буфера в поле Секретный ключ для проверки платежей

mrgs_huawei_app_credentials

7) Нажмите кнопку Сохранить

Внимание!

Huawei: Внешний идентификатор - это не Bundle ID (package name). Внешний идентификатор можно найти в Huawei Console в разделе Мои проекты huawei_console

Samsung🔗

Для валидации платежей не требуются какие-либо Секретные ключи. Достаточно завести приложение в MRGS указав там платформу Samsung

mrgs_samsung_app_settings_base

Игровой центр MyGames🔗

  • Загрузите JSON-файл с продуктами в настройках вашего приложения на сайте MyGames Store

mygames_inapp

Пример JSON для загрузки:

{
   "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"
      }
   ]
}
  • Владелец приложения (менеджер с правами владельца) должен сгенерировать ключ для валидации платежей

mygames_validation_key

  • На сайте MRGS в разделе настроек вашего приложения укажите ключ валидации, сгенерированный на предыдущем шаге

mygames_mrgs_validation

  • На сайте MRGS в разделе настроек in-app продуктов заведите тот же список продуктов, как и на сайте MyGames Store

mygame_inapp_mrgs


Последнее обновление: 2025-01-21
Дата создания: 2020-01-20