Прямой платеж
https://api.maibmerchants.md/v1/pay
Параметры запроса (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)
Стоимость доставки в формате X.XX
items
НЕТ
array
max. 50 items
Товары или услуги из заказа
id
нет
string(36)
ID товара
name
нет
string(128)
Название товара
price
нет
number(decimal)
Цена товара в формате X.XX
quantity
нет
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
Объект содержащий идентификатор транзакции и ссылку перенаправления Покупателя
payId
String
Идентификатор транзакции от maib ecomm
orderId
String
Идентификатор заказа с сайта/приложения
payUrl
String
Ссылка на страницу maib ecomm checkout где Покупателя необходимо перенаправить для ввода данных карты.
ok
Boolean
Статус обработки запроса/транзакции:
true - ошибок нет;
false - есть ошибки (подробности ошибки будут отображаться в errors);
errors
Array
errorCode
String
Код ошибки
errorMessage
String
Описание ошибки
errorArgs
Object
Объект содержит параметры с информацией об ошибке
Пример промежуточного ответа
Параметры окончательного ответа (на Callback Url)
result
Object
Объект содержащий данные транзакции
payId
String
Идентификатор транзакции от maib ecomm
orderId
String
Идентификатор заказа с сайта/приложения
status
String
OK - транзакция завершена успешно.
statusCode
String
Код статуса транзакции
statusMessage
String
Детали статуса транзакции
threeDs
String
AUTHENTICATED - аутентификация прошла успешно.
rrn
String
RRN - Идентификатор транзакции, генерируемый maib.
approval
String
Approval Code - Идентификатор подтверждения транзакции, сгенерированный банком-эмитентом карты.
cardNumber
String
Маскированный номер карты
amount
number(decimal)
Сумма сделки в формате X.XX
currency
String
Валюта транзакции (MDL/EUR/USD)
signature
String
Подпись подтверждения ответа.
Пример окончательного ответа
Last updated