maib e-commerce API
ROEN
  • Терминология
  • Этапы и требования к интеграции
    • Этапы интеграции
    • Требования к интеграции
  • maib e-commerce API
  • Типы платежей
  • Генерация Токена доступа
  • Прямой платеж
  • Двухэтапный платеж
    • Авторизация транзакции
    • Завершение транзакции
  • Возврат платежа
  • Информация о платеже
  • Рекуррентные (регулярные) платежи
    • Регистрация карты в системе maib ecomm
    • Выполнение регулярного платежа
  • One-click платежи
    • Регистрация карты в системе maib ecomm
    • Выполнение one-click платежа
  • Удаление карты из maib ecomm
  • Уведомления на Callback Url
  • Статус транзакции и 3D-Secure
  • Ошибки
    • Ошибки API
    • Коды состояния HTTP
  • Плагины и готовые решения
    • Плагины
    • SDK
    • Tilda
    • Gomag
    • Cartum
    • ECOM
Powered by GitBook
On this page
  • Параметры запроса
  • Параметры ответа
  1. Рекуррентные (регулярные) платежи

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

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
}
{
    "errors": [
        {
            "errorCode": "12001",
            "errorMessage": "Parameter 'amount' is invalid",
            "errorArgs": {
                "parameter": "amount"
            }
        }
    ],
    "ok": false
}
PreviousРегистрация карты в системе maib ecommNextOne-click платежи

Last updated 1 year ago

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

Таблица ошибок
Статус транзакции