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

Введение

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

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

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

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

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

Примечание

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

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

Операции
Операции
Операции
Операции
Операции

Запрос

Получение указанного заказа.

Безопасность
AuthForClient
Путь
project_idintegerобязательный

ID проекта.

Пример: 44056
order_idstringобязательный

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

Пример: 656
curl -i -X GET \
  https://xsolla.redocly.app/_mock/ru/api/digital-distribution-hub/v2/project/44056/distribution_hub/order/656 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Ответы

Успешный запрос данных о заказе.

Телоapplication/json
contentobject(Order_inline_response_200_1_content)

Детали заказа.

order_idinteger

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

Пример: 1
statusstring

Статус заказа: new / paid / done / canceled.

Пример: "paid"
Ответ
application/json
{ "content": { "is_free": "false", "items": [], "price": {} }, "order_id": 1, "status": "paid" }

Создание заказа со всеми предметами из текущей корзины

Запрос

Создание заказа со всеми предметами из корзины. Созданному заказу присваивается статус new.

Безопасность
AuthForClient
Путь
project_idintegerобязательный

ID проекта.

Пример: 44056
Телоapplication/jsonобязательный

Объект с данными для создания заказа.

currencystring(Cart-Payment_settings_currency)обязательный

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

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

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

Пример: 13038
quantityinteger

Количество этого предмета в заказе.

Пример: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/ru/api/digital-distribution-hub/v2/project/44056/distribution_hub/payment/cart \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

Ответы

Заказ успешно создан.

Телоapplication/json
billing_infoobject(Order_inline_response_200_billing_info)

Платежная информация.

order_idinteger

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

Ответ
application/json
{ "billing_info": { "direct_taxes": [], "indirect_taxes": [], "price": {} }, "order_id": 641 }

Создание заказа со всеми предметами из определенной корзины

Запрос

Создание заказа со всеми предметами из указанной корзины. Созданному заказу присваивается статус new.

Безопасность
AuthForClient
Путь
project_idintegerобязательный

ID проекта.

Пример: 44056
cart_idstringобязательный

ID корзины.

Пример: custom_id
Телоapplication/jsonобязательный

Объект с данными для создания заказа.

currencystring(Cart-Payment_settings_currency)обязательный

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

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

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

Пример: 13038
quantityinteger

Количество этого предмета в заказе.

Пример: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/ru/api/digital-distribution-hub/v2/project/44056/distribution_hub/payment/cart/custom_id \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

Ответы

Заказ успешно создан.

Телоapplication/json
billing_infoobject(Order_inline_response_200_billing_info)

Платежная информация.

order_idinteger

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

Ответ
application/json
{ "billing_info": { "direct_taxes": [], "indirect_taxes": [], "price": {} }, "order_id": 641 }