# Возврат платежа При отмене платежа Xsolla отправляет детали отмененной транзакции в вебхуке с типом refund на URL-адрес вебхука. Механизм повторной отправки вебхуков зависит от инициатора возврата платежа: * Если возврат был инициирован на вашей стороне, повторная отправка не выполняется. Платеж возвращается пользователю вне зависимости от полученного ответа на вебхук. * Если возврат был инициирован третьей стороной, например платежной системой или службой поддержки Xsolla, и на вебхук был получен ответ с кодом 5xx, вебхуки отправляются повторно. Максимально выполняется 12 попыток с увеличивающимся интервалом в течение 48 часов с момента первой попытки. Подробная информация о процессе возврата платежа приведена в инструкции. Внимание При одновременном выполнении следующих условий платеж все равно будет возвращен пользователю:Инициатор возврата — Xsolla.На вебхук получен ответ с кодом 4xx, или после всех повторных попыток ответ не был получен, или был получен код 5xx. После сохранения URL-адреса вебхука в Личном кабинете вы можете настроить получение дополнительной информации в вебхуке. Примечание Если вы зарегистрировались в Личном кабинете до 22 января 2025 года (включительно), вы можете найти переключатели в проекте в разделе Настройки > Вебхуки > Тестирование > Payments > Расширенные настройки. Переключатель Описание Показывать информацию о транзакциях сохраненными способами оплаты В вебхуке будет передаваться информация в кастомных параметрах:saved_payment_method:0 — сохраненный способ оплаты не используется;1 — способ оплаты был сохранен при совершении текущей транзакции;2 — используется ранее сохраненный способ оплаты.payment_type:1 — единоразовый платеж;2 — рекуррентный платеж. Коды отмены: Код Причина отмены Описание 1 Cancellation by the user request / the game request Используется, если отмена произошла из Личного кабинета. 2 Chargeback Используется, если по транзакции был chargeback. 3 Integration error Используется в случае проблем с интеграцией между Xsolla и игрой.В этом случае мы не рекомендуем заносить пользователя в черный список. 4 Potential fraud Используется в случае потенциального фрода.В этом случае мы рекомендуем добавить пользователя в черный список. 5 Test payment Используется в случае совершения тестового платежа с последующей отменой.В этом случае мы не рекомендуем заносить пользователя в черный список. 6 User invoice expired Используется, если был выбран способ оплаты с системой отложенного платежа. 7 Fraud notification from PS Используется, если платежная система не произвела выплату по транзакции из-за потенциального фрода.В этом случае мы рекомендуем добавить пользователя в черный список. 8 Cancellation by the PS request Используется, когда платежная система запросила отмену транзакции.В этом случае мы не рекомендуем заносить пользователя в черный список. 9 Cancellation by the user request Используется, если игра или заказ не удовлетворяют требованиям пользователя по каким-либо причинам.В этом случае мы не рекомендуем заносить пользователя в черный список. 10 Cancellation by the game request Используется, когда игра просит отменить транзакцию.В этом случае мы не рекомендуем заносить пользователя в черный список. 11 Account holder called to report fraud Используется, когда владелец аккаунта сообщил, что не совершал данный платеж. 12 Friendly fraud Используется, если нам сообщили о friendly fraud. 13 Duplicate Используется, если произошла попытка повторной оплаты по счету. Endpoint: POST refund Version: 1.0 ## Request fields (application/json): - `custom_parameters` (object) Ваши дополнительные параметры. - `notification_type` (string, required) Тип оповещения. - `payment_details` (object, required) Объект с финансовыми данными платежа. - `payment_details.country_wht` (object) Объект с данными о налоге с дохода, который удерживается с международных транзакций в некоторых странах. - `payment_details.country_wht.amount` (number) Сумма. - `payment_details.country_wht.currency` (string) Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `payment_details.country_wht.percent` (number) Ставка налога, %. - `payment_details.direct_wht` (object) Налог, удерживаемый у источника выплаты. - `payment_details.direct_wht.percent` (number) Процент налога, удерживаемого у источника выплаты. - `payment_details.payment` (object) Объект с данными о сумме, которую оплатил пользователь. - `payment_details.payment_method_fee` (object) Размер комиссии платежной системы. - `payment_details.payment_method_sum` (object) Объект с данными о сумме, которая была оплачена из платежной системы. - `payment_details.payout` (object) Объект с данными о сумме выплаты. - `payment_details.payout_currency_rate` (string) Курс валюты платежа к валюте выплаты. - `payment_details.repatriation_commission` (object) Объект с информацией о затратах на репатриацию, возлагаемых на Xsolla третьими сторонами. - `payment_details.sales_tax` (object) Размер налога (только для США и Канады). - `payment_details.sales_tax.percent` (number) Процент налога. - `payment_details.user_acquisition_fee` (object) Объект с данными о сумме вознаграждения каналов привлечения трафика (аффилированные сети и инфлюенсеры). - `payment_details.user_acquisition_fee.percent` (number) Ставка вознаграждения за привлечение пользователей, %. - `payment_details.vat` (object) Размер VAT (только для Евросоюза). - `payment_details.vat.percent` (number) Процент VAT. - `payment_details.xsolla_balance_sum` (object) Объект с данными о сумме, которая была оплачена с Xsolla-баланса. - `payment_details.xsolla_fee` (object) Размер комиссии Xsolla. - `purchase` (object) Объект с информацией о заказе. - `purchase.checkout` (object) Объект с информацией о заказе. - `purchase.checkout.amount` (number) Сумма заказа. - `purchase.subscription` (object) Объект с данными о подписке. - `purchase.subscription.amount` (number) Сумма покупки. - `purchase.subscription.date_create` (string) Дата создания подписки. Дата и время согласно стандарту [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `purchase.subscription.plan_id` (string) ID плана (внешний id, если план был создан через API). - `purchase.subscription.subscription_id` (integer) ID подписки в базе данных Xsolla. - `purchase.subscription.tags` (array) Теги плана. - `purchase.total` (object, required) Объект с данными об общей стоимости покупки. - `purchase.total.amount` (number) Общая сумма покупки. - `refund_details` (object) Объект с финансовыми данными рефанда. - `refund_details.author` (string) Инициатор возврата платежа. Значение поля передается согласно таблице: Инициатор возврата Значение поля Игра (через API). API Пользователь Личного кабинета (автоматический возврат). Email-адрес пользователя Пользователь Личного кабинета (при участии службы поддержки Xsolla). support@xsolla.com Xsolla (при участии службы поддержки Xsolla). support@xsolla.com - `refund_details.code` (integer) ID кода. - `refund_details.reason` (string) Причина отмены. - `settings` (object) Объект, содержащий настройки проекта. - `settings.merchant_id` (integer) ID продавца. - `settings.project_id` (integer) ID проекта. Вы можете найти этот параметр в [Личном кабинете](https://publisher.xsolla.com/) рядом с названием проекта. - `transaction` (object, required) Объект с информацией о транзакции, связанной с этой операцией. - `transaction.agreement` (integer) ID соглашения. - `transaction.dry_run` (integer) Признак тестовой транзакции. Значение параметра равно 1 для тестового платежа, для реального платежа параметр не передается. - `transaction.external_id` (string) Внешний ID транзакции. - `transaction.id` (integer) ID транзакции. - `transaction.payment_method_order_id` (string) ID платежа в платежной системе. - `user` (object) Объект с информацией о пользователе. - `user.country` (string) Страна пользователя. Используется двухбуквенное обозначение страны согласно стандарту [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). - `user.email` (string) Email пользователя. - `user.id` (string, required) ID пользователя. - `user.ip` (string) IP адрес пользователя. - `user.name` (string) Имя пользователя. - `user.phone` (string) Номер телефона пользователя (в международном формате). - `user.zip` (string) Почтовый индекс. ## Response 400 fields (application/json): - `error` (object) - `error.code` (string) - `error.message` (string) ## Response 204 fields ## Response 500 fields