Перейти к содержимому

Digital Distribution Hub (1.0.0)

Введение

Digital Distribution Hub — новое решение Иксоллы, которое соединяет электронные и физические платежи через технологию push-платежей и e-commerce.

Данная документация включает в себя описание методов API для продуктов Внутриигровой магазин и Платежи. Используется два базовых URL-адреса:

  • https://store.xsolla.com/api для групп Общие, Каталог, Корзина и Заказ.
  • https://ps.xsolla.com для группы Уведомления.

Использование методов API из группы Каталог не требует авторизации.

Чтобы использовать методы API из групп Корзина и Заказ, вам необходимо создать токен.

Примечание

Данная документация не является полностью функциональным интерфейсом и представляет собой дизайн будущего API. В настоящее время вы можете использовать только методы из групп Каталог и Уведомления. Если вы хотите поделиться обратной связью, отправьте нам письмо по адресу techdoc@xsolla.com.
Скачать описание OpenAPI
index.json
index.yaml
Языки
Серверы
Mock server
https://xsolla.redocly.app/_mock/ru/api/digital-distribution-hub/
https://store.xsolla.com/api/

Корзина

Операции

Игровые ключи

Операции

Виртуальные предметы и валюта

Операции

Бандлы

Операции

Токен пользователя

Операции

Уведомления

Операции

Уведомление об отмене

Запрос

Отправьте уведомление об отмене платежа в следующих случаях:

  • платеж не был выполнен;
  • был оформлен возврат платежа.
Телоapplication/json
payment_idintegerобязательный
curl -i -X POST \
  https://xsolla.redocly.app/_mock/ru/api/digital-distribution-hub/push-payments/cancel \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_id": 784998479
  }'

Ответы

OK.

Уведомление об оплате

Запрос

Отправьте это уведомление после успешного списания средств пользователя.

Телоapplication/json
paymentobjectобязательный
payment.​amountnumberобязательный

Сумма платежа.

payment.​currencystring

Валюта платежа. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

payment.​geotype_idintegerобязательный

Идентификатор партнера-дистрибьютора на стороне Иксоллы.

payment.​project_transaction_idstring

Идентификатор транзакции на стороне разработчика игры.

payment.​ps_transaction_idstring

Идентификатор транзакции на стороне партнера-дистрибьютора.

project_idintegerобязательный

ID проекта.

purchaseobjectобязательный
purchase.​order_idintegerобязательный

Идентификатор заказа.

userobjectобязательный
user.​emailstring

Email-адрес пользователя.

user.​idstringобязательный

Уникальный идентификатор пользователя в игре.

user.​phonestring

Номер телефона пользователя.

user.​ps_account_idstring

Идентификатор платежного аккаунта пользователя на стороне партнера-дистрибьютора.

curl -i -X POST \
  https://xsolla.redocly.app/_mock/ru/api/digital-distribution-hub/push-payments/pay \
  -H 'Content-Type: application/json' \
  -d '{
    "payment": {
      "amount": 10,
      "currency": "USD",
      "geotype_id": 13038,
      "ps_transaction_id": "ps_transaction_id"
    },
    "project_id": 18404,
    "purchase": {
      "order_id": 1334430
    },
    "user": {
      "id": "s.ivanov"
    }
  }'

Ответы

OK.

Телоapplication/json
payment_idinteger
Ответ
application/json
{
  "payment_id": 784998484
}

Заказ

Операции