# Отмена заказа (с деталями платежа и транзакции) Xsolla отправляет вебхук order_canceled на указанный URL-адрес, когда платеж отменен пользователем, партнером или автоматически. В вебхуке содержится информация о возвращенных товарах, платежные данные и детали отмененного заказа. Вебхук не отправляется, если оплата не была успешной, например: * платежный интерфейс был открыт, но пользователь не оплатил заказ; * платежный интерфейс был открыт, но при оплате возникли ошибки. Рекомендуемое время обработки вебхука — до 3 секунд. Endpoint: POST order-cancellation Version: 1.0 ## Request fields (application/json): - `billing` (object) Детали платежа и транзакции. - `billing.notification_type` (string, required) Тип оповещения. - `billing.payment_details` (object, required) Объект с финансовыми данными платежа. - `billing.payment_details.country_wht` (object) Объект с данными о налоге с дохода, который удерживается с международных транзакций в некоторых странах. - `billing.payment_details.country_wht.amount` (number) Сумма. - `billing.payment_details.country_wht.currency` (string) Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `billing.payment_details.country_wht.percent` (number) Ставка налога, %. - `billing.payment_details.direct_wht` (object) Налог, удерживаемый у источника выплаты. - `billing.payment_details.direct_wht.percent` (number) Процент налога, удерживаемого у источника выплаты. - `billing.payment_details.payment` (object) Объект с данными о сумме, которую оплатил пользователь. - `billing.payment_details.payment_method_fee` (object) Размер комиссии платежной системы. - `billing.payment_details.payment_method_sum` (object) Объект с данными о сумме, которая была оплачена из платежной системы. - `billing.payment_details.payout` (object) Объект с данными о сумме выплаты. - `billing.payment_details.payout_currency_rate` (string) Курс валюты платежа к валюте выплаты. - `billing.payment_details.repatriation_commission` (object) Объект с информацией о затратах на репатриацию, возлагаемых на Xsolla третьими сторонами. - `billing.payment_details.sales_tax` (object) Размер налога (только для США и Канады). - `billing.payment_details.sales_tax.percent` (number) Процент налога. - `billing.payment_details.user_acquisition_fee` (object) Объект с данными о сумме вознаграждения каналов привлечения трафика (аффилированные сети и инфлюенсеры). - `billing.payment_details.user_acquisition_fee.percent` (number) Ставка вознаграждения за привлечение пользователей, %. - `billing.payment_details.vat` (object) Размер VAT (только для Евросоюза). - `billing.payment_details.vat.percent` (number) Процент VAT. - `billing.payment_details.xsolla_balance_sum` (object) Объект с данными о сумме, которая была оплачена с Xsolla-баланса. - `billing.payment_details.xsolla_fee` (object) Размер комиссии Xsolla. - `billing.purchase` (object) Объект с информацией о заказе. - `billing.purchase.subscription` (object) Объект с данными о подписке. - `billing.purchase.subscription.amount` (number) Сумма покупки. - `billing.purchase.subscription.date_create` (string) Дата создания подписки. Дата и время согласно стандарту [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `billing.purchase.subscription.plan_id` (string) ID плана (внешний id, если план был создан через API). - `billing.purchase.subscription.subscription_id` (integer) ID подписки в базе данных Xsolla. - `billing.purchase.subscription.tags` (array) Теги плана. - `billing.purchase.total` (object, required) Объект с данными об общей стоимости покупки. - `billing.purchase.total.amount` (number) Общая сумма покупки. - `billing.refund_details` (object) Объект с финансовыми данными рефанда. - `billing.refund_details.author` (string) Инициатор возврата платежа. Значение поля передается согласно таблице: Инициатор возврата Значение поля Игра (через API). API Пользователь Личного кабинета (автоматический возврат). Email-адрес пользователя Пользователь Личного кабинета (при участии службы поддержки Xsolla). support@xsolla.com Xsolla (при участии службы поддержки Xsolla). support@xsolla.com - `billing.refund_details.code` (integer) ID кода. - `billing.refund_details.reason` (string) Причина отмены. - `billing.settings` (object) Объект, содержащий настройки проекта. - `billing.settings.merchant_id` (integer) ID продавца. - `billing.settings.project_id` (integer) ID проекта. Вы можете найти этот параметр в [Личном кабинете](https://publisher.xsolla.com/) рядом с названием проекта. - `billing.transaction` (object, required) Объект с информацией о транзакции, связанной с этой операцией. - `billing.transaction.agreement` (integer) ID соглашения. - `billing.transaction.dry_run` (integer) Признак тестовой транзакции. Значение параметра равно 1 для тестового платежа, для реального платежа параметр не передается. - `billing.transaction.external_id` (string) Внешний ID транзакции. - `billing.transaction.id` (integer) ID транзакции. - `billing.transaction.payment_method_order_id` (string) ID платежа в платежной системе. - `custom_parameters` (object) Дополнительная информация. - `items` (array, required) Список предметов, которые купил пользователь. Набор передаваемых параметров в массиве зависит от версии вебхука. В версии 2 дополнительно передаются параметры is_free, is_bonus и is_bundle_content.  Для переключения версии передайте ее номер в параметре version в методе [Обновление информации о настройках вебхуков](/ru/api/igs/operation/update-webhook/). - `order` (object, required) Информация о заказе. - `order.amount` (string, required) Стоимость корзины с учетом выбранной валюты. - `order.comment` (string,null, required) Комментарий пользователя к заказу. - `order.coupons` (array) Примененные купоны. Если купон не был применен, массив не возвращается. - `order.coupons.code` (string) Код примененного купона. - `order.coupons.external_id` (string) Внешний ID. - `order.currency` (string, required) Валюта заказа. Для виртуальной валюты используется артикул, для реальной валюты используется трехбуквенное обозначение согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `order.currency_type` (string, required) Тип валюты платежа. Для бесплатного заказа указывается значение unknown. Enum: "real", "virtual", "unknown", "loyalty_point" - `order.id` (integer, required) Уникальный идентификатор заказа пользователя на стороне Xsolla. - `order.invoice_id` (string,null, required) ID счета для платежей за реальную валюту. Для платежей за виртуальную валюту или для бесплатных товаров передается значение null. - `order.mode` (string, required) Тип платежа. Значение default (по умолчанию) используется для реальных платежей. Значение sandbox используется для тестовых платежей. Enum: "default", "sandbox" - `order.platform` (string,null, required) Платформа платежа. Для платежей через Xsolla используется значение xsolla. Для других платежей используется значение, соответствующее названию платформы публикации игры: playstation_network, xbox_live, pc_standalone, nintendo_shop, google_play, app_store_ios, android_standalone, ios_standalone, android_other, ios_other, pc_other. Enum: "xsolla", "playstation_network", "xbox_live", "pc_standalone", "nintendo_shop", "google_play", "app_store_ios", "android_standalone", "ios_standalone", "android_other", "ios_other", "pc_other" - `order.promocodes` (array) Примененные промокоды. Если промокод не был применен, массив не возвращается. - `order.promocodes.code` (string) Код примененного промокода. - `order.promotions` (array, required) Примененные акции для всего заказа. Массив возвращается, если: - Акция влияет на общую сумму покупки при использовании промокода с настройкой Скидка на покупку. - Скидки на покупку нет, но к заказу добавляются бонусные товары. В этом случае значения стоимости со скидкой ([amount_with_discount](/ru/webhooks/#operation/order-cancellation!path=order/promotions/amount_with_discount&t=request)) и без нее ([amount_without_discount](/ru/webhooks/#operation/order-cancellation!path=order/promotions/amount_without_discount&t=request)) передаются и совпадают, поскольку скидка не применяется. Если акции на уровне заказа не применялись, передается пустой массив. - `order.promotions.amount_with_discount` (string) Стоимость товаров со скидкой. - `order.promotions.amount_without_discount` (string) Стоимость товаров без скидки. - `order.promotions.sequence` (integer) Порядок применения акций. - `order.status` (string, required) Статус заказа. - `user` (object, required) Информация о пользователе. - `user.country` (string) Страна пользователя. Используется двухбуквенное обозначение страны согласно стандарту [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). - `user.email` (string, required) Email-адрес пользователя. - `user.external_id` (string, required) ID пользователя. ## Response 200 fields ## Response 400 fields