Авторизация транзакции
После авторизации транзакции возможны 2 действия:
Завершение транзакции - сумма будет списана со счета Покупателя;
Отмена авторизации транзакции - сумма будет разблокирована, со счета Покупателя ничего не списывается.
API endpoint (POST) |
---|
https://api.maibmerchants.md/v1/hold |
Параметры запроса (body)
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
amount | ДА | number(decimal) ≥1 | Сумма в формате X.XX, подлежащая авторизации (блокировке) на счете Покупателя. Например: 10.25 (currency=MDL) означает 10 лей и 25 бань. |
currency | ДА | string(3) | Валюта транзакции (MDL/EUR/USD) |
clientIp | ДА | string(15) | IP Покупателя |
language | НЕТ | string(2) | Язык страницы maib ecomm checkout Возможные значения: ro/en/ru Если этот параметр не передан, страница будет отображаться на английском языке |
description | НЕТ | string(124) | Описание платежа Отображается на страницу maib ecomm checkout |
clientName | НЕТ | string(128) | Имя Покупателя |
НЕТ | string(40) | Email Покупателя | |
phone | НЕТ | string(40) | Телефон Покупателя |
orderId | НЕТ | string(36) | Идентификатор заказа с сайта/приложения |
delivery | НЕТ | number(decimal) | Стоимость доставки |
items | НЕТ | array max. 50 items | Товары или услуги из заказа *Если передается, то все подпараметры обязательны. |
| нет | string(36) | ID товара |
| нет | string(128) | Название товара |
| нет | number(decimal) | Цена товара |
| нет | integer(32) | Количество товаров |
callbackUrl | НЕТ | string(2048 | Ссылка, по которой Мерчант получит окончательный ответ со статусом и данными транзакции. Если вы не передадите этот параметр, его значение будет взято из maibmerchants. |
okUrl | НЕТ | string(2048) | Ссылка, по которой Покупатель будет перенаправлен в случае успешной транзакции. (GET request: okUrl + payId&orderId) Если вы не передадите этот параметр, его значение будет взято из maibmerchants. |
failUrl | НЕТ | string(2048) | Ссылка, по которой Покупатель будет перенаправлен в случае неудачной транзакции. (GET request: failUrl + payId&orderId) Если вы не передадите этот параметр, его значение будет взято из maibmerchants. |
Пример запроса
Параметры промежуточного ответа
Параметр | Тип | Описание |
---|---|---|
result | Object | Объект, содержащий идентификатор транзакции и ссылку перенаправления Покупателя |
| String | Идентификатор транзакции от maib ecomm |
| String | Идентификатор заказа с сайта/приложения |
| String | Ссылка на страницу maib ecomm checkout где Покупателя необходимо перенаправить для ввода данных карты (или оплатить через Apple Pay / Google Pay) |
ok | Boolean | Статус обработки запроса/транзакции: true - ошибок нет; false - есть ошибки (подробности ошибки будут отображаться в errors); |
errors | Array | Ошибки обработки запроса/транзакций. Таблица ошибок |
| String | Код ошибки |
| String | Описание ошибки |
| Object | Объект содержит параметры с информацией об ошибке |
Пример промежуточного ответа
Параметры окончательного ответа (на Callback Url)
Параметр | Тип | Описание |
---|---|---|
result | Object | Объект содержащий данные транзакции |
| String | Идентификатор транзакции от maib ecomm |
| String | Идентификатор заказа с сайта/приложения |
| String | OK - транзакция завершена успешно. |
| String | Код статуса |
| String | Детали статуса транзакции |
| String | Результат аутентификации 3-D Secure AUTHENTICATED - аутентификация прошла успешно. |
| String | RRN - Идентификатор транзакции, генерируемый maib ecomm.
|
| String | Approval Code - Идентификатор подтверждения транзакции, сгенерированный банком-эмитентом карты.
|
| String | Маскированный номер карты |
| String | Сумма сделки в формате X.XX |
| String | Валюта транзакции (MDL/EUR/USD) |
signature | String | Подпись подтверждения ответа. |
Пример окончательного ответа
Last updated