Персонализация каталога на стороне партнера

Xsolla Developers

или

Персонализация каталога на стороне партнераWebhook POST

Xsolla при взаимодействии пользователя с магазином отправит вебхук partner_side_catalog, который содержит параметры пользователя и проекта, на URL-адрес вебхука.

В ответе вам следует вернуть список item_id или артикулов предметов, которые доступны пользователю. При этом вы также можете передать информацию о том, что конкретный пользователь может купить определенный товар заданное количество раз. Эта возможность позволяет регулировать количество и вид товаров, которые пользователь может добавить в корзину и купить.

Рекомендуется обеспечить время обработки вебхука partner_side_catalog менее 3 секунд.

Request

Request Body schema: application/json

required

object

Объект с информацией о пользователе.

user_id required	string ID пользователя. Если пользователь неавторизован, отправляется значение `null`.
country	string Страна пользователя. Используется двухбуквенное обозначение страны согласно стандарту ISO 3166-1 alpha-2.
currency	string Валюта. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

Responses

200

Верните список товаров, которые доступны пользователю, а также информацию о том, что конкретный пользователь может купить определенный товар заданное количество раз.

404

Пользователь не найден.

Request samples

CURL
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature d90d319f05df7b0f86d2485f48e7079f0f752523' \
-d '{
        "notification_type": "partner_side_catalog",
        "user": {
            "user_id": "12345",
            "country": "US"
        }
    }'

Response samples

application/json

[{"date_from": "2024-08-11T23:59:59+08:00",
"date_until": "2024-08-12T23:59:59+08:00",
"quantity": 0,
"sku": "com.xsolla.boots_1"
},
{"date_from": "2024-08-11T23:59:59+08:00",
"date_until": "2024-08-12T23:59:59+08:00",
"quantity": null,
"sku": "com.xsolla.sword_1"
},
{"quantity": 1,
"sku": "com.xsolla.helmet_1"
}
]