Выполнение регулярного платежа

API endpoint (POST)

https://api.maibmerchants.md/v1/execute-recurring

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

ПараметрОбязательныйТипОписание

billerId

ДА

string(UUID)

Идентификатор карты в ecomm maib

amount

ДА

number(decimal)

Сумма транзакции в формате X.XX

Например: 10.25 (currency=MDL) означает 10 лей и 25 бань.

currency

ДА

string(3)

Валюта транзакции (MDL/EUR/USD)

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)

Количество товаров

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

{
"billerId": "t78i8006-458a-46bc-9e0a-89a6ee11df68",
"amount": 6.25,
"currency": "MDL",
"description": "Description",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Product name",
"price": 2.50,
"quantity": 2
}
]
}

Параметры ответа

ПараметрТипОписание

result

Object

Объект содержащий данные транзакции

  • payId

string(GUID)

Идентификатор транзакции от maib ecomm

  • billerId

string(GUID)

Идентификатор карты в ecomm maib

  • orderId

String

Идентификатор заказа с сайта/приложения

  • status

String

Статус транзакции

OK - транзакция завершена успешно

  • statusCode

String

Код статуса

  • statusCode

String

Детали статуса транзакции

  • rrn

String

RRN - Идентификатор транзакции, генерируемый maib

  • approval

String

Approval Code - Идентификатор подтверждения транзакции, сгенерированный банком-эмитентом карты.

  • cardNumber

String

Маскированный номер карты

  • amount

Number(decimal)

Сумма транзакции в формате X.XX

  • currency

String

Валюта транзакции (MDL/EUR/USD)

ok

Boolean

Статус обработки запроса/транзакции:

true - ошибок нет;

false - есть ошибки (подробности ошибки будут отображаться в errors);

errors

Array

Ошибки обработки запроса/транзакций. Таблица ошибок

  • errorCode

String

Код ошибки

  • errorMessage

String

Описание ошибки

  • errorArgs

Object

Объект содержит параметры с информацией об ошибке

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

Last updated