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
  • 1. Generare Token cu Project ID și Project Secret
  • 2. Generare Token cu Refresh Token
  • 3. Exemplu de request cu autentificare prin Token

Generare Token de acces

PreviousTipuri de plățiNextPlăți directe

Last updated 5 months ago

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 .

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

  • errorCode

string

Cod eroare

  • errorMessage

string

Descriere eroare

  • errorArgs

object

Obiectul conține parametri cu detalii despre eroare

Exemplu răspuns

{
  "result": {
    "accessToken": "xxxxxx",
    "expiresIn": 300,
    "refreshToken": "xxxxxx",
    "refreshExpiresIn": 1800,
    "tokenType": "Bearer"
  },
  "ok": true
}
{
    "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

"result": {
    "accessToken": "xxxxxx",
    "expiresIn": 300,
    "refreshToken": "xxxxxx",
    "refreshExpiresIn": 1800,
    "tokenType": "Bearer"
  },
  "ok": true
}
{
    "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": "customer@gmail.com",
  "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"
}'

Erori procesare request.

maibmerchants
Tabelul cu erori