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

Введение

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/
Операции
Операции

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

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

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

Запрос

Создание заказа со всеми предметами из корзины. Созданному заказу присваивается статус 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 }

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

Запрос

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

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

ID проекта.

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

Артикул предмета.

Пример: booster_mega_1
Тело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/item/booster_mega_1 \
  -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 }