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

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

Если платеж был частично возвращен, а позже возникла необходимость вернуть оставшуюся часть суммы, вам придется обратиться в службу поддержки 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
}

С ошибками

{
    "errors": [
        {
            "errorCode": "12001",
            "errorMessage": "Parameter 'refundAmount' is invalid",
            "errorArgs": {
                "parameter": "refundAmount"
            }
        }
    ],
    "ok": false
}