maib e-commerce API

Interaction with maib ecomm occurs through HTTPS (POST / GET / DELETE) requests to API endpoints with data in JSON format.

The responses received on the website/app from maib ecomm will be HTTPS POST requests with data in JSON format.

All endpoints are structured according to the following pattern: {base-url}/{api-version}/{point}

Base URL: https://api.maibmerchants.md

Current API version: v1

API Endpoints

Endpoint	Description
https://api.maibmerchants.md/v1/generate-token	Access Token generation
https://api.maibmerchants.md/v1/pay	Direct payment
https://api.maibmerchants.md/v1/hold	Payment authorization (two-step payments)
https://api.maibmerchants.md/v1/complete	Payment capture (two-step payments)
https://api.maibmerchants.md/v1/refund	Payment refund
https://api.maibmerchants.md/v1/pay-info	Payment information
https://api.maibmerchants.md/v1/savecard-recurring	Register card (recurring payments)
https://api.maibmerchants.md/v1/execute-recurring	Execute recurring payment (recurring payments)
https://api.maibmerchants.md/v1/savecard-oneclick	Register card (one-click payments)
https://api.maibmerchants.md/v1/execute-oneclick	Execute one-click payment (one-click payments)
https://api.maibmerchants.md/v1/delete-card	Deleting the card (recurring and one-click payments)

Interaction via API

E.g for Direct Payment:

1. Customer chooses product or service in Merchant online shop (website/app) and adds it to his cart.

2. The Customer presses the «Place order» button, and the Merchant sends an HTTPS POST request (with transaction data) to the API endpoint.

3. maib ecomm returns an intermediate response containing the link (payUrl).

4. The Customer is redirected to the payUrl link and access the maib ecomm checkout page.

5. The Customer enters the card data (or pay via Apple Pay/Google Pay).

6. The maib ecomm processes the transaction.

7. The Customer is redirected back to the Merchant online shop (website/app), on okUrl or failUrl (depending on the status of the transaction).

8. The Merchant online shop receives (on callbackUrl via HTTPS POST request) a final response containing the status and basic transaction data.

Postman Collection

3KB

API_maib_e-commerce.postman_collection.zip

archive