Выполнение one-click платежа

API endpoint (POST)

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

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

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

billerId

ДА

string(UUID)

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

clientIp

ДА

string(15)

IP Покупателя

amount

ДА

number(decimal)

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

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

currency

ДА

string(3)

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

language

НЕТ

string(2)

Язык страницы maib ecomm checkout

Возможные значения: ro/en/ru

Если этот параметр не передан, страница будет отображаться на английском языке.

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)

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

callbackUrl

НЕТ

string(2048)

Ссылка, по которой Мерчант получит окончательный ответ со статусом и данными транзакции.

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

okUrl

НЕТ

string(2048)

Ссылка, по которой Покупатель будет перенаправлен в случае успешной транзакции.

(GET request: okUrl + payId&orderId&billerId)

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

failUrl

НЕТ

string(2048)

Ссылка, по которой Покупатель будет перенаправлен в случае неудачной транзакции.

(GET request: failUrl + payId&orderId&billerId)

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

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

{
"billerId": "t78i8006-458a-46bc-9e0a-89a6ee11df68",
"clientIp": "135.250.245.121",
"amount": 6.25,
"currency": "MDL",
"description": "Описание",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Товар",
"price": 2.50,
"quantity": 2
}
],
"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, где покупатель должен быть перенаправлен для ввода CVV2/CVC2 (можно исключить) и пройти аутентификацию 3DS.

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(UUID)

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

  • billerId

String(UUID)

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

  • orderId

String

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

  • status

String

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

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

  • statusCode

String

Код статуса

  • statusMessage

String

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

  • threeDs

String

Результат аутентификации 3-D Secure

AUTHENTICATED - аутентификация прошла успешно.

  • rrn

String

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

  • 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",
"billerId": "t78i8006-458a-46bc-9e0a-89a6ee11df68",
"orderId": "123",
"status": "OK",
"statusCode": "000",
"statusMessage": "Approved",
"threeDs": "AUTHENTICATED",
"rrn": "331711380059",
"approval": "327593",
"cardNumber": "510218******1124",
"amount": 6.25,
"currency": "MDL"
},
"signature": "r4KwwIUXQGHhcEM7C4um8o9rSrGEriTRcYQuBbmjEec="
}

Last updated