Регистрация карты в системе maib ecomm

API endpoint (POST)

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

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

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

billerExpiry

ДА

string(4)

Дата (месяц/год) до которой карта будет храниться в системе maib ecomm.

Формат значения: MMYY (например: 1229 -> 31 декабря 2029 / 23:59:59).

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

clientIp

ДА

string(15)

IP Покупателя

amount

НЕТ*

string(2)

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

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

*При передаче параметра со счета Покупателя будет списана это сумма и карта будет зарегистрирована в системе maib ecomm.

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

currency

ДА

string(3)

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

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)

Стоимость доставки

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)

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

Пример

{
"billerExpiry": "1225",
"amount": 6.25,
"currency": "MDL",
"clientIp": "135.250.245.121",
"language": "ru",
"description": "Описание",
"clientName": "Имя Фамилия",
"email": "customer@gmail.com",
"phone": "069123456",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Товар 1",
"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 где Покупателя необходимо перенаправить для ввода данных карты (или оплатить через Apple Pay / Google Pay).

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

  • billerId

String

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

Мерчант будет инициировать следующие платежи (execute-recurring) с передачей этого идентификатора в запросе .

  • billerExpiry

String

Дата (месяц/год) до которой данные карты будут храниться в системе maib ecomm

Формат значения: MMYY (например: 1229 = 31 декабря 2029 / 23:59:59).

  • orderId

String

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

  • status

String

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

OK - Если параметр amount был передан и транзакция прошла успешно (данные карты были сохранены).

PENDING - Если параметр amount не был передан (данные карты были сохранены).

  • 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",
"billerExpiry": "1225",
"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