Xsolla-logo

Request refund

put/merchants/{merchant_id}/reports/transactions/{transaction_id}/refund

Sends a refund request to return a payment to a user. Read about the Refund feature to learn more about the process.

Note

This API method can't be used under high load. When the number of requests is high, rate limits may apply. Contact your Account Manager to find out the rate limits for this API method.
Request
Security:
basicAuth
path Parameters
merchant_id
required
integer

Merchant ID.

transaction_id
required
integer

Transaction ID.

Request Body schema: application/json
description
required
string <= 4000 characters

Reason for a refund.

email
string <= 100 characters

User email.

Responses
200

OK (No error).

204

No Content (No error).

401

Unauthorized (Access denied).

404

Transaction Not Found.

422

Unprocessable Entity (Invalid request parameters).

Request samples
    6 more
    JavaScript
    Node.js
    Python
    C#
    Go
    Java
application/json
{
  • "description": "test refund request"
}
Response samples
    1 more
    422
application/json
{
  • "message": "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."
}