# Request partial refund

Sends a request for a partial refund to a user. Refer to our documentation for detailed information about the refund process and payment methods that support partial refunds.


  NoteYou can call this API method in sandbox mode. To do this, pass the test payment data in the request. Refer to the instruction for more information about sandbox mode access and testing scenarios.





  NoticeThis API call does not contain the project_id path parameter, so you need to use the API key that is valid in all the company’s projects to set up authorization.

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

## Path parameters:

  - `merchant_id` (integer, required)
    Merchant ID.

  - `transaction_id` (integer, required)
    Transaction ID.

## Request fields (application/json):

  - `description` (string, required)
    Reason for a refund.

  - `refund_amount` (number, required)
    The refund amount in a purchase currency.

## Response 404 fields (application/json):

  - `message` (string)
    Transaction with specified ID does not exist. Please check payment credentials. Otherwise, contact Xsolla support at support@xsolla.com.

## Response 422 fields (application/json):

  - `message` (string)
    Refund is not acceptable

Returns one of the following messages:
- 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

Returns one of the following messages:
- 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.

Cannot execute partial refund because of wrong precision

Returns the following message:
- Partial refund is unavailable because requested amount is specified with incorrect precision for purchase currency.


## Response 204 fields

## Response 403 fields