# Частичный возврат платежа

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

После сохранения URL-адреса вебхука в Личном кабинете вы можете настроить 
получение дополнительной информации в вебхуке. Для этого в разделе Настройки 
проекта > Вебхуки > Расширенные настройки установите следующий 
переключатель в активное положение.


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




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


    
        Показывать информацию о транзакциях сохраненными способами оплаты
        В вебхуке будет передаваться информация в кастомных параметрах:saved_payment_method:0 — сохраненный способ оплаты не используется;1 — способ оплаты был сохранен при совершении текущей транзакции;2 — используется ранее сохраненный способ оплаты.payment_type:1 — единоразовый платеж;2 — рекуррентный платеж.
    



Коды отмены:


    
    
        Код
        Причина отмены
        Описание
    
    
    
    
        1
        Cancellation by the user request / the game request
        Используется, если отмена произошла из Личного кабинета.
    
    
        3
        Integration error
        Используется в случае проблем с интеграцией между Xsolla и игрой.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        5
        Test payment
        Используется в случае совершения тестового платежа с последующей отменой.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        7
        Fraud notification from PS
        Используется, если платежная система не произвела выплату по транзакции из-за потенциального фрода.В этом случае мы рекомендуем добавить пользователя в черный список.
    
    
        9
        Cancellation by the user request
        Используется, если игра или заказ не удовлетворяют требованиям пользователя по каким-либо причинам.В этом случае мы не рекомендуем заносить пользователя в черный список.
    
    
        10
        Cancellation by the game request
        Используется, когда игра просит отменить транзакцию.В этом случае мы не рекомендуем заносить пользователя в черный список.

Endpoint: POST partial-refund
Version: 1.0

## Request fields (application/json):

  - `custom_parameters` (object)
    Ваши дополнительные параметры.

  - `notification_type` (string, required)
    Тип оповещения.

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

  - `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_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.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.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.date` (string)
    Дата возврата платежа.

  - `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.date` (string)
    Дата транзакции.

  - `transaction.dry_run` (integer)
    Признак тестовой транзакции. Значение параметра равно 1 для тестового платежа, для реального платежа параметр не передается.

  - `transaction.external_id` (string)
    Внешний ID транзакции.

  - `transaction.id` (integer)
    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