Generare Token de acces

API endpoint (POST)
https://api.maibmerchants.md/v1/generate-token

Pentru a genera Token-ul de acces aveți nevoie de Project ID și Project Secret care sunt disponibile după activarea Proiectului în maibmerchants.

Flow autentificare prin Token de acces:

1. Efectuați un request folosind Project ID / Project Secret către endpoint-ul de generare token. Dacă datele transmise sunt valide veți primi ca răspuns Token (expirare Token) și Refresh Token (expirare Refresh Token).

2. Dacă Token-ul a expirat folosiți Refresh Token pentru genera un nou Token de acces. În cazul în care și Refresh Token a expirat folosiți Project ID / Project Secret (vedeți pct. 1).

3. Efectuați request-uri către maib ecomm folosind Token-ul de acces.

1. Generare Token cu Project ID și Project Secret

Parametri pentru request (body)

Parametru	Obligatoriu	Tip	Descriere
projectId	DA	string (uiid)	Project ID din maibmerchants
projectSecret	DA	string (uiid)	Poject Secret din maibmerchants

Exemplu request (CURL)

curl --location --request POST "https://api.maibmerchants.md/v1/generate-token" \
    --header 'Content-Type: application/json' \
    --data-raw '{
    "projectId": "95f48bc4-bb2d-4682-a2a6-c573fe1a35ca",
    "projectSecret": "60462913-da44-47fa-8c82-146b676729b9"
    }'

Parametri răspuns (instant)

Parametru	Tip	Descriere
result	object	Obiect care conține Token și Refresh Token.
accessToken	string	Token de acces.
expiresIn	integer	Durata de viață a tokenului, în secunde.
refreshToken	string	Refresh Token pentru generarea unui nou Token de acces.
refreshExpiresIn	integer	Durata de viață Refresh Token, în secunde.
tokenType	string	Tip token (Bearer)
ok	boolean	Stare procesare request. true - nu sunt erori false - sunt erori (detaliile despre erori vor fi în 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

Fără erori

{
  "result": {
    "accessToken": "xxxxxx",
    "expiresIn": 300,
    "refreshToken": "xxxxxx",
    "refreshExpiresIn": 1800,
    "tokenType": "Bearer"
  },
  "ok": true
}

Cu erori

{
    "errors": [
        {
            "errorCode": "11001",
            "errorMessage": "Invalid credentials. Please check 'projectId' and 'projectSecret' parameters"
        }
    ],
    "ok": false
}

2. Generare Token cu Refresh Token

Parametri pentru request (body)

Parametru	Obligatoriu	Tip	Descriere
refreshToken	DA	string	Refresh Token

Exemplu request (CURL)

curl --location --request POST "https://api.maibmerchants.md/v1/generate-token" \
    --header 'Content-Type: application/json' \
    --data-raw '{
    "refreshToken": "xxxxxxxxxxxxx"
    }'

Exemplu răspuns

Fără erori

"result": {
    "accessToken": "xxxxxx",
    "expiresIn": 300,
    "refreshToken": "xxxxxx",
    "refreshExpiresIn": 1800,
    "tokenType": "Bearer"
  },
  "ok": true
}

Cu erori

{
    "errors": [
        {
            "errorCode": "11002",
            "errorMessage": "Invalid or expired 'refreshToken' parameter"
        }
    ],
    "ok": false
}

3. Exemplu de request cu autentificare prin Token

curl -X 'POST' \
  'https://api.maibmerchants.md/v1/pay' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer access_token' \
  -H 'Content-Type: application/json' \
  -d '{
  "clientIp": "135.250.245.121",
  "amount": 10.25,
  "currency": "MDL",
  "description": "Descriere",
  "language": "ro",
  "orderId": "123",
  "clientName": "Client Name",
  "email": "[e-mail]",
  "phone": "069123456",
  "delivery": 1.25,
  "items": [
    {
      "id": "123",
      "name": "Produs",
      "price": 2.5,
      "quantity": 2
    }
  ],
  "callbackUrl": "https://example.com/callback",
  "okUrl": "https://example.com/ok",
  "failUrl": "https://example.com/fail"
}'