maib e-commerce API
RUEN
  • Terminologie
  • Etape și cerințe pentru integrare
    • Etapele integrării
    • Cerințe pentru integare
  • maib e-commerce API
  • Tipuri de plăți
  • Generare Token de acces
  • Plăți directe
  • Plăți în 2 etape
    • Autorizare tranzacție
    • Finalizare tranzacție
  • Returnare plată
  • Informație despre plată
  • Plăți recurente
    • Înregistrare card în sistemul maib ecomm
    • Executare plată recurentă
  • Plăți one-click
    • Înregistrare card în sistemul maib ecomm
    • Executare plată one-click
  • Ștergere card din maib ecomm
  • Notificări pe Callback URL
  • Starea tranzacției și 3D-Secure
  • Erori
    • Erori API
    • Coduri de stare HTTP
  • Plugin-uri si soluții gata
    • Plugin-uri
    • SDK
    • Tilda
    • Gomag
    • Cartum
    • ECOM
Powered by GitBook
On this page
  • Parametri request (URL path)
  • Parametri răspuns

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)

Parametru
Obligatoriu
Tip
Descriere

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

Parametru
Tip
Descriere

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

  • 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
}
{
    "errors": [
        {
            "errorCode": "13002",
            "errorMessage": "Payment ID 'f16a9006-128a-46bc-8e2a-77a6ee99df75' not found",
            "errorArgs": {
                "paymentId": "f16a9006-128a-46bc-8e2a-77a6ee99df75"
            }
        }
    ],
    "ok": false
}

PreviousReturnare platăNextPlăți recurente

Last updated 1 year ago

Erori procesare request.

Tabelul cu erori
Starea tranzacției
Rezultatul autentificării 3-D Secure