RUEN

Executare plată one-click

API endpoint (POST)

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

Parametri pentru request (body)

Parametru
Obligatoriu
Tip
Descriere

billerId

DA

string(UUID)

Identificatorul cardului salvat în maib ecomm.

amount

DA

number(decimal)

Suma tranzacției în formatul X.XX

De exemplu: 10.25 (valuta MDL) -> 10 lei și 25 bani

currency

DA

string (3)

Valuta tranzacției (MDL/EUR/USD)

clientIp

DA

string(15)

IP Cumpărător

language

NU

string(2)

Limba în care va fi afișată pagina maib ecomm checkout.

Valori posibile: ro/en/ru.

Dacă acest parametru nu este transmis, pagina va fi afișată în limba engleză.

description

NU

string(124)

Descrierea plății.

Se afișează pe pagina maib ecomm checkout

orderId

NU

string(36)

Identificatorul comenzii de pe website/app

delivery

NU

number(decimal)

Costul livrării în format X.XX

items

NU

array

max. 50 items

Produsele sau serviciile din coșul Cumpărătorului

  • id

nu

string(36)

ID produs

  • name

nu

string(128)

Nume produs

  • price

nu

number(decimal)

Preț produs în format X.XX

  • quantity

nu

integer(32)

Cantitatea produselor

callbackUrl

NU

string(2048)

Link-ul unde Merchant-ul va primi răspunsul final cu starea și datele tranzacției.

Dacă nu se transmite acest parametru valoarea sa va fi preluată din maibmerchants.

okUrl

NU

string(2048)

Link-ul unde Cumpărătorul va fi redirecționat dacă tranzacția este reușită.

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

Dacă nu se transmite acest parametru valoarea sa va fi preluată din maibmerchants.

failUrl

NU

string(2048)

Link-ul unde Cumpărătorul va fi redirecționat dacă tranzacția a eșuat.

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

Dacă nu se transmite acest parametru valoarea sa va fi preluată din maibmerchants.

Exemplu

{
"billerId": "92f72473-f324-42d7-95fd-9c75c2947408",
"clientIp": "135.250.245.121",
"amount": 6.25,
"currency": "MDL",
"description": "Descriere",
"orderId": "123",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Produs",
"price": 2.50,
"quantity": 2
}
],
"callbackUrl": "https://example.com/callback",
"okUrl": "https://example.com/ok",
"failUrl": "https://example.com/fail"
}

Parametri răspuns intermediar

Parametru
Tip
Descriere

result

object

Obiect care conține identificatorul tranzacției și link-ul pentru redirecționare Cumpărător

  • payId

string

Identificatorul tranzacției atribuit de către maib ecomm

  • orderId

string

Identificatorul comenzii de pe website/app

  • payUrl

string

Link-ul către pagina maib ecomm checkout unde Cumpărătorul trebuie să fie redirecționat pentru a introduce CVV2/CVC2 (poate fi exclus) și va trece autentificarea 3DS.

ok

boolean

Stare procesare request/tranzacție:

true - nu sunt erori;

false - sunt erori (detaliile despre erori vor fi în afișate în errors);

errors

array

  • errorCode

string

Cod eroare

  • errorMessage

string

Descriere eroare

  • errorArgs

object

Obiectul conține parametri cu detalii despre eroare

Exemplu răspuns intermediar

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"payUrl": "https://maib.ecommerce.md/ecomm01/ClientHandler?trans_id=rEsfhyIk8s9ypxkcS9fj/3C8FqA="
},
"ok": true
}

Răspuns final (pe Callback URL)

Parametru
Tip
Descriere

result

object

Obiect care conține datele tranzacției

  • payId

string

Identificatorul tranzacției atribuit de către maib ecomm

  • billerId

string

Identificatorul cardului salvat în maib ecomm.

  • orderId

string

Identificatorul comenzii de pe website/app

  • status

string

  • statusCode

string

Codul stării tranzacției

  • statusMessage

string

Detalii despre starea tranzacției

  • threeDs

string

  • rrn

string

RRN - Identificatorul tranzacției generat de către maib ecomm

  • approval

string

Approval Code - Identificatorul de aprobare a tranzacției generat de către banca emitentă a cardului

  • cardNumber

string

Numărul cardului hașurat

  • amount

number(decimal)

Suma tranzacției în format X.XX

  • currency

string

Valuta tranzacției (MDL/EUR/USD)

signature

string

Semnătură validare răspuns.

Exemplu răspuns final (pe Callback URL)

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"billerId": "92f72473-f324-42d7-95fd-9c75c2947408",
"orderId": "123",
"status": "OK",
"statusCode": "000",
"statusMessage": "Approved",
"rrn": "331711380059",
"approval": "327593",
"cardNumber": "510218******1124",
"amount": 6.25,
"currency": "MDL"
},
"signature": "xxxxxxxxxxxxxxxxxxxx"
}
PreviousÎnregistrare card în sistemul maib ecommNextȘtergere card din maib ecomm

Last updated