Informație despre plată

API endpoint (GET)

https://api.maibmerchants.md/v1/pay-info/{payId}

Asigurați-vă că antetul Content-Type și body sunt excluse din request-urile către acest endpoint.

Parametri request (URL path)

ParametruObligatoriuTipDescriere

payId

DA

string(UUID)

Identificatorul tranzacției

Exemplu request (SHELL)

curl --location --request GET 'https://api.maibmerchants.md/v1/pay-info/f16a9006-128a-46bc-8e2a-77a6ee99df75' \
--header 'Authorization: Bearer access_token' \

Parametri răspuns

ParametruTipDescriere

result

object

Obiect care conține datele tranzacției

  • payId

string

Identificatorul tranzacției atribuit de către maib ecomm

  • orderId

string

Identificatorul comenzii de pe website/app

  • billerId

string

Identificatorul cardului salvat în maib ecomm (pentru plăți recurring/one-click).

  • billerExpiry

string

Data (lună/an) pînă la care datele cardului vor fi păstrate în sistemul maib ecomm (pentru plăți recurring/one-click).

Formatul valorii MMYY (de ex. 1229 - decembrie 2029).

  • 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

  • confirmAmount

number(decimal)

Suma debitată de pe contul Cumpărătorului în format X.XX (pentru plățile în 2 etape).

  • refundAmount

number(decimal)

Suma returnată Cumpărătorului în format X.XX (pentru plățile returnate).

  • currency

string

Valuta tranzacției (MDL/EUR/USD)

  • description

string

Descrierea plății

  • clientIp

string

IP Cumpărător

  • clientName

string

Nume Cumpărător

  • email

string

Email Cumpărător

  • phone

string

Telefon Cumpărător

  • delivery

number(decimal)

Costul livrării în format X.XX

  • items

array

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

- id

string

ID produs

- name

string

Nume produs

- price

number(decimal)

Preț produs în format X.XX

- quantity

integer

Cantitatea produselor

ok

boolean

Stare procesare request:

true - nu sunt erori;

false - sunt erori.

Detaliile despre erori vor fi afișate în errors.

errors

array

Erori procesare request. Tabelul cu erori

  • errorCode

string

Cod eroare

  • errorMessage

string

Descriere eroare

  • errorArgs

object

Obiectul conține parametri cu detalii despre eroare

Exemplu răspuns

{
"result": {
"payId": "f16a9006-128a-46bc-8e2a-77a6ee99df75",
"orderId": "123",
"billerId": "t78i8006-458a-46bc-9e0a-89a6ee11df68",
"billerExpiry": "1225",
"status": "OK",
"statusCode": "000",
"statusMessage": "Approved",
"threeDs": "AUTHENTICATED",
"rrn": "331711380059",
"approval": "327593",
"cardNumber": "510218******1124",
"amount": 10.25,
"confirmAmount": 10.25,
"refundAmount": 10.25,
"currency": "MDL",
"description": "Descriere",
"clientIp": "127.0.0.1",
"clientName": "Nume Prenume",
"email": "customer@gmail.com",
"phone": "069123456",
"delivery": 1.25,
"items": [
{
"id": "10",
"name": "Produs 1",
"price": 2.50,
"quantity": 2,
"total": 5
},
{
"id": "11",
"name": "Produs 2",
"price": 4,
"quantity": 1,
"total": 4
}
]
},
"ok": true
}

Last updated