Xsolla-logo

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).

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 -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": {
            "id": "12345",
            "country": "US"
        }
    }'
Response samples
application/json
[
  • {
    },
  • {
    },
  • {
    }
]