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

- Добавьте все продукты, которые пользователь может купить в вашем приложении. Вы можете заполнить поля вручную либо импортировать их в формате CSV
Зачем заполнять таблицу с товарами
Для конвертации валют внутри платежей MRGS использует API сайта ЦБ РФ. Если, указанной в платеже, валюты нет на сайте ЦБ РФ, то MRGS возьмет цену в USD из таблицы SKU. Важно Данная информация используется только при обработке платежей на сервере. SDK MRGS на клиенте не получает этот список SKU и всегда загружает информацию по продуктам только из магазина приложений.
В случае, если пришедшего платежа нет в нашей админке и мы не смогли сконвертировать пришедшую валюту в доллары через api, то тогда в MRGS и Террабанк попадет 0. MyTracker.MyUA, 1Link собирает платежи отдельно от MRGS, через MyTracker.
Верификация🔗
Верификация на сервере MRGS обеспечит достоверность отчетов по встроенным платежам, а также защитит Вас от мошеннических схем начисления награды внутри игры.
Для корректной верификации платежей на сервере MRGS, Вам необходимо заполнить ряд параметров в разделе настройки приложения.
iOS🔗
- Получите ключ из App Store credentials согласно документации
-
Добавьте полученный ключ в MRGS:
-
Откройте сайт MRGS и зайдите в меню редактирования приложения

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

-
Нажмите кнопку "Сохранить"
-
Amazon🔗
Получите Amazon Shared Key:
1) Перейдите по ссылке в раздел Identity. Убедитесь что зашли на аккаунт где расположен ваш проект.
2) Скопируйте ключ в буфер обмена.

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

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

5) Нажмите кнопку Сохранить
Android🔗
- Получите Google Play credentials:
1. Создайте новый Service Account🔗
Отройте Google Cloud console и выберете ваш project.
Нажмите кнопку +CREATE SERVICE ACCOUNT в верхней части страницы.

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

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

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

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

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

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

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

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

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

Убедитесь что у вас выставлены следующие разрешения:
- View app information (read-only)
- View financial data
- Manage orders and subscriptions.
И нажмите кнопку Apply в нижней части страницы.

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

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

5. Вставьте credentials JSON в настройки проекта MRGS🔗
- Откройте сайт MRGS и зайдите в меню редактирования приложения.

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

- Нажмите кнопку Сохранить
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.

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

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

7) Нажмите кнопку Сохранить
Внимание!
Huawei: Внешний идентификатор - это не Bundle ID (package name). Внешний идентификатор можно найти в Huawei Console в разделе Мои проекты 
Samsung🔗
Для валидации платежей не требуются какие-либо Секретные ключи. Достаточно завести приложение в MRGS указав там платформу Samsung

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

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

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

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

Дата создания: 2020-01-20