Выполнение 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	Товары или услуги из заказа
id	нет	string(36)	ID товара
name	нет	string(128)	Название товара
price	нет	number(decimal)	Цена товара
quantity	нет	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.

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

{
"billerId": "t78i8006-458a-46bc-9e0a-89a6ee11df68",
"clientIp": "135.250.245.121",
"amount": 6.25,
"currency": "MDL",
"description": "Описание",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Товар",
"price": 2.50,
"quantity": 2
}
],
"callbackUrl": "https://example.com/callback",
"okUrl": "https://example.com/ok",
"failUrl": "https://example.com/fail"
}

Параметры промежуточного ответа

Параметр	Тип	Описание
result	Object	Объект содержащий идентификатор транзакции и ссылку перенаправления Покупателя
payId	String	Идентификатор транзакции от maib ecomm
orderId	String	Идентификатор заказа с сайта/приложения
payUrl	String	Ссылка на страницу maib ecomm checkout, где покупатель должен быть перенаправлен для ввода CVV2/CVC2 (можно исключить) и пройти аутентификацию 3DS.
ok	Boolean	Статус обработки запроса/транзакции: true - ошибок нет; false - есть ошибки (подробности ошибки будут отображаться в errors);
errors	Array	Ошибки обработки запроса/транзакций. Таблица ошибок
errorCode	String	Код ошибки
errorMessage	String	Описание ошибки
errorArgs	Object	Объект содержит параметры с информацией об ошибке

Пример промежуточного ответа

Без ошибок

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"payUrl": "https://maib.ecommerce.md/ecomm01/ClientHandler?trans_id=rEsfhyIk8s9ypxkcS9fj/3C8FqA="
},
"ok": true
}

С ошибками

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

Параметры окончательного ответа (на Callback Url)

Параметр	Тип	Описание
result	Object	Объект содержащий данные транзакции
payId	String(UUID)	Идентификатор транзакции от maib ecomm
billerId	String(UUID)	Идентификатор карты в ecomm maib
orderId	String	Идентификатор заказа с сайта/приложения.
status	String	Статус транзакции OK - транзакция завершена успешно.
statusCode	String	Код статуса
statusMessage	String	Детали статуса транзакции
threeDs	String	Результат аутентификации 3-D Secure AUTHENTICATED - аутентификация прошла успешно.
rrn	String	RRN - Идентификатор транзакции, генерируемый maib ecomm.
approval	String	Approval Code - Идентификатор подтверждения транзакции, сгенерированный банком-эмитентом карты.
cardNumber	String	Маскированный номер карты.
amount	Number(decimal)	Сумма транзакции в формате X.XX
currency	String	Валюта транзакции (MDL/EUR/USD).
signature	String	Подпись подтверждения ответа.

Пример окончательного ответа

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"billerId": "t78i8006-458a-46bc-9e0a-89a6ee11df68",
"orderId": "123",
"status": "OK",
"statusCode": "000",
"statusMessage": "Approved",
"threeDs": "AUTHENTICATED",
"rrn": "331711380059",
"approval": "327593",
"cardNumber": "510218******1124",
"amount": 6.25,
"currency": "MDL"
},
"signature": "r4KwwIUXQGHhcEM7C4um8o9rSrGEriTRcYQuBbmjEec="
}