# Request refund

Sends a refund request to return a payment to a user. Read about the [Refund
feature](https://developers.xsolla.com/doc/pay-station/features/refund/) to
learn more about the process.


  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}/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.

  - `email` (string)
    User email.

## Response 200 fields (application/json):

  - `message` (string)
    Can return one of the following messages:
- No content.
- The request for a refund has been accepted. Xsolla CS will manually complete the refund. It may take up to two business days.
- The request for a refund has been accepted. Xsolla CS will automatically send the customer an email with alternative refund options as the user's method does not support direct refunds.

## Response 404 fields (application/json):

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

## Response 422 fields (application/json):

  - `message` (string)
    Can return one of the following messages:
- We are processing the refund request. This may take up to two business days.
- We are reaching the user for the information required for the refund. For details, contact Xsolla Support.
- Incorrect payment status. Refund is possible only for payments with "completed" or "error" status.
- To process this request, the customer's email address field must be filled. Please specify the customer's email address and try again.
- Full refund is unavailable because there are successful partial refunds for this transaction.
- Refund failed. Please contact Xsolla Support to process it manually.
- Dispute for this invoice is already opened. Can’t make a refund yet.


## Response 204 fields

## Response 401 fields