# Возврат платежа

При отмене платежа Xsolla отправляет детали отмененной транзакции в вебхуке с 
типом refund на URL-адрес вебхука.

Механизм повторной отправки вебхуков зависит от инициатора возврата платежа:
* Если возврат был инициирован на вашей стороне, повторная отправка не 
  выполняется. Платеж возвращается пользователю вне зависимости от полученного 
  ответа на вебхук.
* Если возврат был инициирован третьей стороной, например платежной системой или 
  службой поддержки Xsolla, и на вебхук был получен ответ с кодом 5xx, вебхуки 
  отправляются повторно. Максимально выполняется 12 попыток с увеличивающимся 
  интервалом в течение 48 часов с момента первой попытки.

Подробная информация о процессе возврата платежа приведена в инструкции.


Внимание
При одновременном выполнении следующих условий платеж все равно будет возвращен пользователю:Инициатор возврата — Xsolla.На вебхук получен ответ с кодом 4xx, или после всех повторных попыток ответ не был получен, или был получен код 5xx.


После сохранения URL-адреса вебхука в аккаунте вы можете настроить получение дополнительной информации в вебхуке.


Примечание
Если вы зарегистрировались в Личном кабинете до 22 января 2025 г. (включительно), переключатели располагаются в вашем проекте в разделе Настройки &gt; Вебхуки &gt; Тестирование &gt; Payments &gt; Расширенные настройки
 .




    
        Переключатель
        Описание
    


    
        Показывать информацию о транзакциях сохраненными способами оплаты
        В вебхуке будет передаваться информация в кастомных параметрах: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 – AFS reject
        Используется, когда транзакция была отклонена из-за потенциального фрода, который обнаружила система Xsolla Anti-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
        Potential fraud – friendly fraud
        Используется, когда законный держатель карты оспорил свою транзакцию.
    
    
        13
        Duplicate
        Используется, если произошла попытка повторной оплаты по счету.
    
    
        21
        Potential fraud – BIN attack
        Используется, когда происходит массовая кража данных карт с одним или несколькими BIN. Особенность: всплеск попыток использования одинаковых BIN за короткий промежуток времени, зачастую с использованием последовательных номеров карт.
    
    
        22
        Potential fraud – monetization fraud
        Используется, когда товары, доступные для обмена, были куплены с помощью украденной карты с целью перепродажи.
    
    
        23
        Potential fraud – low-scale card fraud
        Используется, когда происходит кража данных карт с одним или несколькими BIN. Не такая масштабная и скоординированная, как атака по BIN (код отмены 21).
    
    
        24
        Potential fraud – regional price abuse
        Используется при злоупотреблении региональными ценами или перепродажей ключей. Пользователи воспользовались региональными ценами — зачастую через смену геолокации или подмену информации о способе оплаты — чтобы дешевле купить товары и перепродать их по более высоким ценам.
    
    
        25
        Potential fraud – partner or PS exploit
        Используется, когда происходит кража учетных данных и захват аккаунта. Относится к злоупотреблению учетной записью или интеграцией на стороне партнера или платежной системы, а не к использованию карты.
    
    
        26
        Potential fraud – not definable
        Используется, когда фрод был подтвержден, но доказательств недостаточно, чтобы определить конкретный тип атаки.
    
    
        27
        Fraud notification from PS – linked transactions
        Используется, когда транзакция отсутствует в отчете платежной системы по фроду, но она связана с другими мошенническими транзакциями. Например, платежи по таким транзакциям могут быть сделаны с помощью одинакового номера карты или устройства и возвращены пользователям по причинам, связанным с фродом.

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.amount` (number)
    Сумма.

  - `payment_details.direct_wht.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.direct_wht.percent` (number)
    Процент налога, удерживаемого у источника выплаты.

  - `payment_details.payment` (object)
    Объект с данными о сумме, которую оплатил пользователь.

  - `payment_details.payment.amount` (number)
    Сумма.

  - `payment_details.payment.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payment_method_fee` (object)
    Размер комиссии платежной системы.

  - `payment_details.payment_method_fee.amount` (number)
    Сумма.

  - `payment_details.payment_method_fee.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payment_method_sum` (object)
    Объект с данными о сумме, которая была оплачена из платежной системы.

  - `payment_details.payment_method_sum.amount` (number)
    Сумма.

  - `payment_details.payment_method_sum.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payout` (object)
    Объект с данными о сумме выплаты.

  - `payment_details.payout.amount` (number)
    Сумма.

  - `payment_details.payout.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payout_currency_rate` (string)
    Курс валюты платежа к валюте выплаты.

  - `payment_details.repatriation_commission` (object)
    Объект с информацией о затратах на репатриацию, возлагаемых на Xsolla третьими сторонами.

  - `payment_details.repatriation_commission.amount` (number)
    Сумма.

  - `payment_details.repatriation_commission.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.sales_tax` (object)
    Размер налога (только для США и Канады).

  - `payment_details.sales_tax.amount` (number)
    Сумма.

  - `payment_details.sales_tax.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.sales_tax.percent` (number)
    Процент налога.

  - `payment_details.user_acquisition_fee` (object)
    Объект с данными о сумме вознаграждения каналов привлечения трафика (аффилированные сети и инфлюенсеры).

  - `payment_details.user_acquisition_fee.amount` (number)
    Сумма.

  - `payment_details.user_acquisition_fee.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.user_acquisition_fee.percent` (number)
    Ставка вознаграждения за привлечение пользователей, %.

  - `payment_details.vat` (object)
    Размер VAT (только для Евросоюза).

  - `payment_details.vat.amount` (number)
    Сумма.

  - `payment_details.vat.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.vat.percent` (number)
    Процент VAT.

  - `payment_details.xsolla_balance_sum` (object)
    Объект с данными о сумме, которая была оплачена с Xsolla-баланса.

  - `payment_details.xsolla_balance_sum.amount` (number)
    Сумма.

  - `payment_details.xsolla_balance_sum.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.xsolla_fee` (object)
    Размер комиссии Xsolla.

  - `payment_details.xsolla_fee.amount` (number)
    Сумма.

  - `payment_details.xsolla_fee.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase` (object)
    Объект с информацией о заказе.

  - `purchase.checkout` (object)
    Объект с информацией о заказе.

  - `purchase.checkout.amount` (number)
    Сумма заказа.

  - `purchase.checkout.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase.subscription` (object)
    Объект с данными о подписке.

  - `purchase.subscription.amount` (number)
    Сумма покупки.

  - `purchase.subscription.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `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)
    Общая сумма покупки.

  - `purchase.total.currency` (string)
    Валюта. Используется трехбуквенное обозначение валюты согласно стандарту [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `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 проекта. Вы можете найти этот параметр в вашем [аккаунте](/ru/webhooks/overview/#business-accounts) рядом с названием проекта.

  - `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
