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
  • Параметры запроса (body)
  • Параметры ответа
  1. Двухэтапный платеж

Завершение транзакции

API endpoint (POST)

https://api.maibmerchants.md/v1/complete

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

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

payId

ДА

String(UUID)

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

confirmAmount

НЕТ

number(decimal)

Сумма к списанию со счета Покупателя в формате X.XX

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

Может быть меньше или равна той сумме, которая была ранее заблокирована.

Если этот параметр отсутствует, будет списана вся ранее заблокированная сумма.

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

{
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"confirmAmount": 10.25
}

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

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

result

Object

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

  • payId

String

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

  • orderId

String

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

  • status

String

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

  • statusCode

String

Код статуса

  • statusMessage

String

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

  • rrn

String

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

  • approval

String

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

  • cardNumber

String

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

  • confirmAmount

String

Сумма списанная со счета Покупателя в формате X.XX

ok

Boolean

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

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

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

errors

Array

  • errorCode

String

Код ошибки

  • errorMessage

String

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

  • errorArgs

Object

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

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

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"status": "OK",
"statusCode": "000",
"statusMessage": "Approved",
"confirmAmount": 10.25
},
"ok": true
}
{
    "errors": [
        {
            "errorCode": "12001",
            "errorMessage": "Parameter 'confirmAmount' is invalid",
            "errorArgs": {
                "parameter": "confirmAmount"
            }
        }
    ],
    "ok": false
}
PreviousАвторизация транзакцииNextВозврат платежа

Last updated 1 year ago

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

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