В главное меню

Отмена платежа


Введение

Данный метод позволяет вернуть все денежные средства - возвращаются все деньги в том числе и торговая уступка. Выполнить данную операцию можно только в течении 70 часов после совершения оплаты.

На тестовой среде данный метод отрабатывает только в течении первого часа после совершения платежа. По истечении часа, мы не гарантируем работу данного метода, т.к. это ограничения тестовой среды.

Входные параметры

Заголовок запроса

POST
Endpoint: https://sandbox.pay.mts.ru/private/v1/payments/{id}/reversal HTTP/1.1
Content-Type: application/json
<Основные параметры>

Параметр запроса

Поле

Тип

Обяз.

Описание

id

int64

да

Идентификатор платежа

Основные параметры

Поле

Тип

Обяз.

Описание

Request-IdguidдаИдентификатор конкретного запроса

Requestor-Name

string

нет

Наименование сервиса.

  • Для веба - домен, на котором запущен виджет.
  • Для SDK - идентификатор приложения.
  • Для API - имя вызывающей системы.
Requestor-Typestringнет

Тип витрины.

  • API
  • Web Widget
  • Web Page
  • SDK Apple
  • SDK Android
Requestor-VersionstringнетВерсия виджета/sdk

Тело запроса

Поле

Тип

Обяз.

Описание

receiptId

int64

нет

id операции фискализации

Выходные параметры

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело ответа

Поле

Тип

Обяз.

Описание

id

int64

да

Идентификатор возврата

processingData

object

нет

Дополнительная информация об операции

resultobjectдаДетали проведения оплаты

Описание структуры processingData

Поле

Тип

Обяз.

Описание

rrn

string

нет

RRN Банка

Структура result

Поле

Тип

Обяз.

Описание

statusstatusEnumда

Статус платежа 

  • inProgress - в процессе исполнения
  • executed - выполнен

Пример

Заголовок запроса

POST https://sandbox.pay.mts.ru/private/v1/payments/10234/reversal HTTP/1.1
Host:
Content-Type: application/json
Request-Id: 599e4b42-e7ef-4e1b-80fb-cc59119c0dce

Заголовок ответа

Content-Type: application/json; charset=utf-8
http-code: 200
http-status: OK

Тело

{
  "id": 177898,
  "result": {
    "status": "inProgress"
  }
}
{
  "id": 0,
  "result": {
    "status": "executed"
  },
  "processingData": {
    "rrn": "string"
  }
}

Возможные коды ошибок

code

message

userMessage

00299998

Validation error

Не пройдена валидация данных

00299999

An unexpected error has occurred

Непредвиденная ошибка

02000001This method is not supported for this payment tool. Payment tool: {paymentToolType}Данный метод не поддерживается для этого способа оплаты. Способ оплаты: {paymentToolType}
02000003Invalid operation for current payment status: Current status: {0}Платеж в статусе над которым данная операция запрещена

02000004

Payment {0} not found from merchant {1}

Платеж не найден

02000005It was not succeeded to reversal payment. There was time for possibility of execution of operationОтменить платеж не удалось. Вышло время на возможность выполнения операции

02005000

Processing: Not identified error

Не классифицированная ошибка

02005007PCEK: service unavailableСервис временно недоступен. Попробуйте повторить позже.
02005027PCEK Provider: On this payment reversaling is executed earlier extSystemErrorCode: [errorCode]По данному платежу выполнена отмена ранее

02005028

Processing: On this payment refunding is executed earlier

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

02005042PCEK: service unavailable. extSystemErrorCode: [errorCode]Сервис временно недоступен
02005059Bank acquirer: reversal is not possible, try calling a refund. extSystemErrorCode: [errorCode]Отмена невозможна, попробуйте совершить возврат
02005061Bank acquirer: general error. extSystemErrorCode: [errorCode]Банк отклонил платёж
02005064Bank issuer: payment restriction. extSystemErrorCode: [errorCode]Ваш банк ограничил оплату с выбранной карты
02005065Bank acquirer: fatal general error. extSystemErrorCode: [errorCode]Банк отклонил платёж