maib e-commerce API
Interacțiunea cu maib ecomm are loc prin request-uri HTTPS (POST / GET / DELETE) către endpoint-urile API cu date în format JSON.
Răspunsurile returnate de maib ecomm către soluția dvs. ecommerce (website/app), pe Callback URL, vor fi request-uri HTTPS POST cu date în format JSON.
Toate endpont-urile sunt structurate după următorul șablon: {base-url}/{api-version}/{point}
Base URL: api.maibmerchants.com
Versiunea actuală API: v1
Endpoint-uri API
| Endpoint | Descriere |
|---|---|
https://api.maibmerchants.md/v1/generate-token | |
https://api.maibmerchants.md/v1/pay | |
https://api.maibmerchants.md/v1/hold | Autorizare tranzacție (plată în 2 etape) |
https://api.maibmerchants.md/v1/complete | Finalizare tranzacție (plată în 2 etape) |
https://api.maibmerchants.md/v1/refund | |
https://api.maibmerchants.md/v1/pay-info | |
https://api.maibmerchants.md/v1/savecard-recurring | Înregistrare card în maib ecomm (plăți recurente) |
https://api.maibmerchants.md/v1/execute-recurring | Executare plată recurentă (plăți recurente) |
https://api.maibmerchants.md/v1/savecard-oneclick | Înregistrare card în maib ecomm (plăți one-click) |
https://api.maibmerchants.md/v1/execute-oneclick | Executare plată one-click (plăți one-click) |
https://api.maibmerchants.md/v1/delete-card | Ștergere card din maib ecomm (plăți recurente și one-click) |
Interacțiunea prin API
Cumpărătorul intră pe website/app, selectează produsul sau serviciul pe care dorește să-l cumpere și îl adaugă în coș.
Cînd Cumpărătorul apasă butonul "Achită comanda" se execută un request HTTPS POST către endpoint-ul API maib ecommerce, cu datele tranzacției în format JSON.
maib ecomm returnează instant un răspuns intermediar care conține un link (payUrl).
Cumpărătorul este redirecționat pe payUrl și ajunge pe pagina maib ecomm checkout.
Cumpărătorul introduce datele cardului (sau achită prin Apple Pay / Google Pay).
Sistemul maib ecomm procesează tranzacția.
Cumpărătorul este redirecționat înapoi pe website/app, pe okUrl sau failUrl în funcție de starea tranzacției (reușită sau eșuată).
maib ecomm transmite pe callbackUrl o notificare cu răspunsul final ce conține starea și datele tranzacției.
Postman Collection
Last updated