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

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

Параметры запроса (body)

Параметр	Обязательный	Тип	Описание
billerExpiry	ДА	string(4)	Дата (месяц/год) до которой данные карты будут храниться в системе maib ecomm (для рекуррентных/one-click платежей). Формат значения: MMYY (например: 1229 -> 31 декабря 2029 / 23:59:59). Если срок действия карты ниже значения, переданного в этом параметре, то данные карты будут храниться до истечение срока действия карты.
clientIp	ДА	string(15)	IP Покупателя
amount	НЕТ*	number(decimal) ≥1	Сумма транзакции в формате 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": "xxxxx",
"clientName": "Имя Фамилия",
"email": "[e-mail]",
"phone": "069123456",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Product 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 где Покупателя необходимо перенаправить для ввода данных карты.
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	Идентификатор карты в ecomm maib. Мерчант будет инициировать следующие платежи (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
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": "92f72473-f324-42d7-95fd-9c75c2947408",
"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": "xxxxxxxxxxxxxxxxxxxx"
}

Без параметра "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": "xxxxxxxxxxxxxxxxxxxx"
}