Регистрация карты в системе maib ecomm

API endpoint (POST)
https://api.maibmerchants.md/v1/savecard-oneclick

Параметры запроса

Параметр	Обязательный	Тип	Описание
billerExpiry	ДА	string(4)	Дата (месяц/год) до которой карта будет храниться в системе maib ecomm. Формат значения: MMYY (например: 1229 -> 31 декабря 2029 / 23:59:59). Если срок действия карты ниже значения, переданного в этом параметре, то данные карты будут храниться до окончания срока действия карты.
clientIp	ДА	string(15)	IP Покупателя
amount	НЕТ*	string(2)	Сумма транзакции в формате X.XX Например: 10.25 (currency=MDL) означает 10 лей и 25 бань. *При передаче параметра со счета Покупателя будет списана это сумма и карта будет зарегистрирована в системе maib ecomm. *Если параметр не передан, то карта будет зарегистрирована без списания со счета Покупателя.
currency	ДА	string(3)	Валюта транзакции (MDL/EUR/USD)
language	НЕТ	string(2)	Язык страницы maib ecomm checkout Возможные значения: ro/en/ru Если этот параметр не передан, страница будет отображаться на английском языке.
description	НЕТ	string(124)	Описание платежа Отображается на странице maib ecomm checkout
clientName	НЕТ	string(128)	Имя Покупателя
email	НЕТ	string(40)	Email Покупателя
phone	НЕТ	string(40)	Телефон Покупателя
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) Если вы не передадите этот параметр, его значение будет взято из maibmerchants.

Пример

{
"billerExpiry": "1225",
"amount": 6.25,
"currency": "MDL",
"clientIp": "135.250.245.121",
"language": "ru",
"description": "Описание",
"clientName": "Имя Фамилия",
"email": "[e-mail]",
"phone": "069123456",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Товар 1",
"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 где Покупателя необходимо перенаправить для ввода данных карты (или оплатить через Apple Pay / Google Pay).
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": "12034",
            "errorMessage": "Parameter 'billerExpiry' has invalid format. Valid format is 'MMYY'",
            "errorArgs": {
                "parameter": "billerExpiry"
            }
        }
    ],
    "ok": false
}

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

Параметр	Тип	Описание
result	Object	Объект содержащий данные транзакции
payId	String	Идентификатор транзакции от maib ecomm
billerId	String	Идентификатор карты в maib ecomm Мерчант будет инициировать следующие платежи (execute-recurring) с передачей этого идентификатора в запросе .
billerExpiry	String	Дата (месяц/год) до которой данные карты будут храниться в системе maib ecomm Формат значения: MMYY (например: 1229 = 31 декабря 2029 / 23:59:59).
orderId	String	Идентификатор заказа с сайта/приложения
status	String	Статус транзакции OK - Если параметр amount был передан и транзакция прошла успешно (данные карты были сохранены). PENDING - Если параметр amount не был передан (данные карты были сохранены).
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	Подпись подтверждения ответа

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

Был отправлен параметр "amount"

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

Без параметра "amount"

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"billerId": "t78i8006-458a-46bc-9e0a-89a6ee11df68",
"billerExpiry": "1225",
"orderId": "123",
"status": "PENDING",
"threeDs": "AUTHENTICATED",
"cardNumber": "510218******1124",
"amount": 0,
"currency": "MDL"
},
"signature": "r4KwwIUXQGHhcEM7C4um8o9rSrGEriTRcYQuBbmjEec="
}