Xsolla-logo

Возврат платежаServer-side

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

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

Примечание

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

Внимание

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

SecuritybasicAuth
Request
path Parameters
merchant_id
required
integer

ID продавца.

transaction_id
required
integer

ID транзакции.

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

Причина отмены платежа.

email
string <= 100 characters

Email пользователя.

Responses
200

OK (Успешный ответ).

204

Возврат платежа успешно проведен.

401

Unauthorized (Отказано в доступе).

404

Транзакция не найдена.

422

Unprocessable Entity (Параметры не верны).

Request samples
application/json
{
  • "description": "test refund request"
}
Response samples
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."
}