Catalog API (2.0.0)
- Version: 2.0.0
- Servers:
https://store.xsolla.com/api - Contact Us by Email
- Contact URL: https://xsolla.com/
- Required TLS version: 1.2
Catalog API предоставляет методы для управления каталогом вашего внутриигрового магазина и обработки покупок. Используйте методы для настройки виртуальных предметов, виртуальных валют, игровых ключей, бандлов, процессов корзины и оплаты, атрибутов товаров, а также для импорта товаров из внешних источников.
Запрос
Генерирует заказ и платежный токен для него. Заказ генерируется на основе товаров, переданных в теле запроса.
Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей ссылкой: https://secure.xsolla.com/paystation4/?token={token}, где {token} — полученный токен.
Для целей тестирования используйте этот URL-адрес: https://sandbox-secure.xsolla.com/paystation4/?token={token}.
Параметр
user.country.value используется для выбора валюты для заказа. Если страна пользователя неизвестна,
альтернативным вариантом является указание IP-адреса пользователя в X-User-Ip заголовке. Для корректной работы метода требуется один из этих двух вариантов.
Выбранная валюта используется для оплаты в Pay Station.
ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
Ваши пользовательские параметры представлены в виде допустимого набора пар ключ-значение в формате JSON.
Вы можете передать дополнительные параметры через это поле для настройки фильтров защиты от мошенничества. Смотрите документацию Pay Station.
Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
Передайте значение true, чтобы провести тестовые платежи. Обратите внимание, что URL для страницы оплаты будет https://sandbox-secure.xsolla.com.
Объект с реквизитами юридического лица. Объект и все его параметры обязательны, если user.is_legal имеет значение true.
- Mock serverhttps://xsolla.redocly.app/_mock/ru/api/catalog/v3/project/{project_id}/admin/payment/token
- https://store.xsolla.com/api/v3/project/{project_id}/admin/payment/token
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
-u <username>:<password> \
https://xsolla.redocly.app/_mock/ru/api/catalog/v3/project/44056/admin/payment/token \
-H 'Content-Type: application/json' \
-d '{
"purchase": {
"items": [
{
"quantity": 2,
"sku": "com.xsolla.cup01"
},
{
"quantity": 1,
"sku": "com.xsolla.t-shirt01"
},
{
"quantity": 1,
"sku": "com.xsolla.cup01"
},
{
"quantity": 1,
"sku": "com.xsolla.hat01"
}
]
},
"settings": {
"currency": "USD",
"external_id": "AABBCCDD01",
"language": "de",
"payment_method": 1380,
"return_url": "https://developers.xsolla.com/ru/",
"ui": {
"theme": "63295aab2e47fab76f7708e3"
}
},
"user": {
"country": {
"allow_modify": false,
"value": "US"
},
"email": {
"value": "user@xsolla.com"
},
"id": {
"value": "user-id"
},
"name": {
"value": "user-name"
}
}
}'{ "order_id": 12345, "token": "huooAqbXBSJxB8Q4dYBqJp4ybiInqsPb" }