Catalog personalization on partner side

Catalog personalization on partner sideWebhook POST

Xsolla will send a partner_side_catalog webhook that contains the user and project parameters to the webhook URL when a user interacts with the store.

Return a list of item_id or item SKU that are available to the user in response. In this case, you can also include information that a particular user can buy a certain product a specified number of times. This feature allows you to control the number and type of products that the user can add to the cart and buy.

It is recommended that the processing speed of the partner_side_catalog webhook is less than 3 seconds.

Request

Request Body schema: application/json

required

object

User details (object).

user_id required	string User ID.
country	string User’s country. Two-letter uppercase ISO 3166-1 alpha-2 country code.
currency	string Currency. Three-letter currency code per ISO 4217.

Responses

200

Return a list of items available to user and number of times a particular user can buy a certain item.

404

User not found.

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

[{"sku": "boots",
"quantity": 0,
"date_from": "2024-08-11T23:59:59+08:00",
"date_until": "2024-08-12T23:59:59+08:00"
},
{"sku": "sword",
"quantity": null,
"date_from": "2024-08-11T23:59:59+08:00",
"date_until": "2024-08-12T23:59:59+08:00"
},
{"sku": "helmet",
"quantity": 1
}
]