Иксолла отправляет вебхук order_paid
на указанный URL-адрес, когда
выполнены условия:
payment
.В вебхуке order_paid
содержится информация о купленных товарах и
детали транзакции.
Вебхук order_paid
не будет отправлен, если:
payment
не получен.Рекомендуется обеспечить скорость обработки вебхука order_paid
менее 3 секунд.
Ожидаемые коды ответов описаны в разделе Responses. Вы можете использовать другие коды ответов. В зависимости от кода ответа и подключения функциональности автоматического возврата платежа логика обработки вебхука на стороне Иксоллы следующая:
Код ответа | Автоматический возврат платежа не включен (по умолчанию) | Автоматический возврат платежа включен |
---|---|---|
400 , 401 , 402 , 403 , 404 , 409 , 422 , 415 |
Нет действий | Автоматический возврат средств пользователю. |
200 , 201 , 204 |
Нет действий | Нет действий |
Другой код или отсутствие ответа на вебхук | Многократная отправка вебхуков через заданный временной промежуток: 2 попытки с шагом 5 минут, 7 попыток с шагом 15 минут, 10 попыток с шагом 60 минут. | Многократная отправка вебхуков через заданный временной промежуток: 2 попытки с шагом 5 минут, 7 попыток с шагом 15 минут, 10 попыток с шагом 60 минут. Если все вебхуки отправлены, а успешный ответ не получен, осуществляется автоматический возврат средств пользователю. |
Для подключения функциональности автоматических возвратов обратитесь к аккаунт-менеджеру проекта или напишите на am@xsolla.com.
notification_type required | string Тип оповещения. | ||||||||||||||||||||||||||||||||||||||
required | Array of objects Список предметов, которые купил пользователь. | ||||||||||||||||||||||||||||||||||||||
Array | |||||||||||||||||||||||||||||||||||||||
required | object Информация о заказе. | ||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
required | object Информация о пользователе. | ||||||||||||||||||||||||||||||||||||||
custom_parameters | object Дополнительная информация. |
Верните, чтобы сообщить об успешной обработке вехбука.
Верните в случае ошибки в предоставленной информации (например, обязательный параметр не передан, или авторизация не прошла).
{- "custom_parameters": { },
- "items": [
- {
- "amount": "string",
- "custom_attributes": null,
- "is_pre_order": true,
- "promotions": [
- {
- "amount_with_discount": "string",
- "amount_without_discount": "string",
- "sequence": 0
}
], - "quantity": 0,
- "sku": "string",
- "type": "virtual_good"
}
], - "notification_type": "string",
- "order": {
- "amount": "string",
- "comment": "string",
- "coupons": [
- {
- "code": "string",
- "external_id": "string"
}
], - "currency": "string",
- "currency_type": "real",
- "id": 0,
- "invoice_id": "string",
- "mode": "default",
- "platform": "xsolla",
- "promocodes": [
- {
- "code": "string",
- "external_id": "string"
}
], - "promotions": [
- {
- "amount_with_discount": "string",
- "amount_without_discount": "string",
- "sequence": 0
}
], - "status": "string"
}, - "user": {
- "email": "string",
- "external_id": "string"
}
}