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

Отправка запроса на частичный возврат платежа пользователю. Подробная 
информация о процессе возврата, а также список способов оплаты, которые 
поддерживают оформление частичного возврата, приведены в 
документации.


ПримечаниеВы можете использовать этот метод API в тестовом окружении (sandbox-режиме). Для этого передайте в запросе данные тестового платежа. Подробную информацию об открытии тестового окружения и сценариях тестирования читайте в инструкции.





ВниманиеЭтот метод API не включает в себя path-параметр project_id, поэтому для авторизации вам необходимо использовать ключ API, который действует во всех проектах.

Endpoint: PUT /merchants/{merchant_id}/reports/transactions/{transaction_id}/partial_refund
Version: 2.0
Security: basicAuth

## Path parameters:

  - `merchant_id` (integer, required)
    ID продавца.

  - `transaction_id` (integer, required)
    ID транзакции.

## Request fields (application/json):

  - `description` (string, required)
    Причина отмены платежа.

  - `refund_amount` (number, required)
    Сумма возврата в валюте покупки.

## Response 404 fields (application/json):

  - `message` (string)
    Транзакции с указанным ID не существует. Проверьте данные платежа или свяжитесь со службой поддержки Xsolla по адресу support@xsolla.com.

## Response 422 fields (application/json):

  - `message` (string)
    Возврат платежа недоступен

Возможны следующие варианты ответов:
- Partial refund is unavailable for operations with user balance.
- Requested transaction is partial refund and cannot be canceled.
- Partial refund is unavailable for subscription payments.
- Refund cannot be completed due to a payment system error. Please try again 
  later.
- Requested partial refund amount exceeds payment amount.
- Requested partial refund amount is less than minimum amount specified by 
  payment system.
- Payment amount after partial refund will be less than allowable amount 
  specified by payment system.
- Dispute for this invoice is already opened. Can’t make a refund yet.

Платежный метод не поддерживает частичные возвраты

Возможны следующие варианты ответов:
- Current payment method does not support partial refunds.
- Current transaction status does not allow refunds.
- Deadline for refund is exceeded.
- Partial refund is unavailable because discount was applied during payment 
  creation.

Неправильный формат ввода валюты

Возможен следующий вариант ответа:
- Partial refund is unavailable because requested amount is specified with 
  incorrect precision for purchase currency.


## Response 204 fields

## Response 403 fields