Выполнение one-click платежа
API endpoint (POST) |
---|
https://api.maibmerchants.md/v1/execute-oneclick |
Параметры запроса
Параметр | Обязательный | Тип | Описание |
---|---|---|---|
billerId | ДА | string(UUID) | Идентификатор карты в ecomm maib. |
clientIp | ДА | string(15) | IP Покупателя |
amount | ДА | number(decimal) | Сумма транзакции в формате X.XX Например: 10.25 (currency=MDL) означает 10 лей и 25 бань. |
currency | ДА | string(3) | Валюта транзакции (MDL/EUR/USD) |
language | НЕТ | string(2) | Язык страницы maib ecomm checkout Возможные значения: ro/en/ru Если этот параметр не передан, страница будет отображаться на английском языке. |
description | НЕТ | string(124) | Описание платежа Отображается на странице maib ecomm checkout |
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&billerId) Если вы не передадите этот параметр, его значение будет взято из maibmerchants. |
failUrl | НЕТ | string(2048) | Ссылка, по которой Покупатель будет перенаправлен в случае неудачной транзакции. (GET request: failUrl + payId&orderId&billerId) Если вы не передадите этот параметр, его значение будет взято из maibmerchants. |
Пример запроса
Параметры промежуточного ответа
Параметр | Тип | Описание |
---|---|---|
result | Object | Объект содержащий идентификатор транзакции и ссылку перенаправления Покупателя |
| String | Идентификатор транзакции от maib ecomm |
| String | Идентификатор заказа с сайта/приложения |
| String | Ссылка на страницу maib ecomm checkout, где покупатель должен быть перенаправлен для ввода CVV2/CVC2 (можно исключить) и пройти аутентификацию 3DS. |
ok | Boolean | Статус обработки запроса/транзакции: true - ошибок нет; false - есть ошибки (подробности ошибки будут отображаться в errors); |
errors | Array | Ошибки обработки запроса/транзакций. Таблица ошибок |
| String | Код ошибки |
| String | Описание ошибки |
| Object | Объект содержит параметры с информацией об ошибке |
Пример промежуточного ответа
Параметры окончательного ответа (на Callback Url)
Параметр | Тип | Описание |
---|---|---|
result | Object | Объект содержащий данные транзакции |
| String(UUID) | Идентификатор транзакции от maib ecomm |
| String(UUID) | Идентификатор карты в ecomm maib |
| String | Идентификатор заказа с сайта/приложения. |
| String | OK - транзакция завершена успешно. |
| String | Код статуса |
| String | Детали статуса транзакции |
| String | Результат аутентификации 3-D Secure AUTHENTICATED - аутентификация прошла успешно. |
| String | RRN - Идентификатор транзакции, генерируемый maib ecomm. |
| String | Approval Code - Идентификатор подтверждения транзакции, сгенерированный банком-эмитентом карты. |
| String | Маскированный номер карты. |
| Number(decimal) | Сумма транзакции в формате X.XX |
| String | Валюта транзакции (MDL/EUR/USD). |
signature | String | Подпись подтверждения ответа. |
Пример окончательного ответа
Last updated