Прямой платеж

API endpoint (POST)

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)

Имя Покупателя

email

НЕТ

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.

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

{
"amount": 10.25,
"currency": "MDL",
"clientIp": "135.250.245.121",
"language": "ru",
"description": "xxxxxx",
"clientName": "Имя Фамилия",
"email": "customer@gmail.com",
"phone": "069123456",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Товар 1",
"price": 2.50,
"quantity": 2
},
{
"id": "11",
"name": "Товар 2",
"price": 4,
"quantity": 1
}
],
"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
}

Параметры окончательного ответа (на 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

Подпись подтверждения ответа.

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

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

Last updated