maib MIA QR API
RO
RO
  • Overview
    • Specificații tehnice generale
    • Tipuri QR MIA
  • Endpoint-uri
    • Autentificare
      • Obținere token de autentificare
    • Inițiere plată
      • Creare cod QR (Static, Dinamic)
      • Creare cod QR Hibrid
        • Creare extensie pentru codul QR după ID
    • Anulare plată
      • Anulare QR activ (Static, Dinamic)
      • Anulare extensie QR activ (Hibrid)
    • Rambursare plată
      • Rambursare plată efectuată (Refund)
    • Extragere informații (GET)
      • Afișare listă QR-uri cu opțiuni de filtrare
      • Afișare detalii QR după ID
      • Afișare listă plăți cu opțiuni de filtrare
      • Afișare detalii despre plăți după ID
  • Simulare plată (Sandbox)
  • Notificări pe Callback URL
  • Erori
    • Erori API
    • Coduri de stare HTTP
  • Glosar
  • maib e-commerce API
Powered by GitBook
On this page
  1. Endpoint-uri
  2. Autentificare

Obținere token de autentificare

POST /v2/auth/token

Acest endpoint permite obținerea unui Access Token necesar pentru autorizarea tuturor solicitărilor ulterioare către API-ul QR MIA.


Parametrii cererii (body)

Parametru
Tip
Obligatoriu
Descriere

clientId

string (guid)

Da

Codul clientului, oferit de maib

clientSecret

string (guid)

Da

Cheia secretă a clientului, oferită de maib

Example request (body)

{
  "clientId": "749c564f-1a65-48e3-a4bf-b7932b6ae3db",
  "clientSecret": "0d922db8-9a2f-4c66-a60d-76a762c9bb04"
}

Parametrii răspunsului

Câmp
Tip
Descriere

result.accessToken

string

Token-ul de acces ce trebuie folosit în header-ul Authorization

result.expiresIn

integer

Durata de viață a token-ului, în secunde

result.tokenType

string

Tipul token-ului (Bearer)

ok

boolean

true dacă solicitarea a fost procesată cu succes

errors

array

Lista erorilor, dacă ok = false

Example response

{
  "result": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expiresIn": 300,
    "tokenType": "Bearer"
  },
  "ok": true
}

Utilizare Access Token

După obținerea token-ului, acesta trebuie inclus în header-ul fiecărei solicitări către API-ul QR MIA, sub forma:

Exemplu utilizare (curl)

curl -X POST https://api.example.com/v2/mia/qr \
  -H "Authorization: Bearer {{access_token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Dynamic",
    "expiresAt": "2029-10-22T10:32:28+03:00",
    "amountType": "Fixed",
    "amount": 50.00,
    "currency": "MDL",
    "description": "Order description",
    "callbackUrl": "https://example.com/callback",
    "redirectUrl": "https://example.com/success"
  }'
PreviousAutentificareNextInițiere plată

Last updated 2 days ago