Возврат платежа

Возврат может быть частичным или полным и может быть осуществлен только один раз.

Если платеж был частично возвращен, а позже возникла необходимость вернуть оставшуюся часть суммы, вам придется обратиться в службу поддержки maib ecomm.

API endpoint (POST)

https://api.maibmerchants.md/v1/refund

Параметры запроса (body)

ПараметрОбязательныйТипОписание

payId

ДА

string

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

refundAmount

НЕТ

number(decimal)

Сумма, возвращаемая Покупателю в формате X.XX

Например: 10.25 (currency=MDL) означает 10 лей и 25 бань.

Может быть меньше или равна сумме транзакции.

Если этот параметр не передан, будет возвращена полная сумма транзакции.

Пример

{
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"refundAmount": 10.25
}

Параметры ответа

ПараметрТипОписание

result

Object

Объект содержащий данные транзакции

  • payId

String

Идентификатор транзакции от maib ecomm

  • orderId

String

Идентификатор заказа с сайта/приложения

  • status

String

Статус возврата.

OK - платеж успешно возвращен.

  • statusCode

String

Код статуса

  • statusMessage

String

Детали статуса транзакции

  • refundAmount

String

Сумма возвращенная Покупателю в формате X.XX

ok

Boolean

Статус обработки запроса/транзакции:

true - ошибок нет;

false - есть ошибки (подробности ошибки будут отображаться в errors);

errors

Array

Ошибки обработки запроса/транзакций. Таблица ошибок

  • errorCode

String

Код ошибки

  • errorMessage

String

Описание ошибки

  • errorArgs

Object

Объект содержит параметры с информацией об ошибке

Пример ответа

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"status": "OK",
"statusCode": "400",
"statusMessage": "Accepted",
"refundAmount": 10.25
},
"ok": true
}

Last updated