maib MIA QR API
EN
EN
  • Overview
    • General Technical Specifications
    • MIA QR Types
  • Endpoints
    • Authentication
      • Obtain Authentication Token
    • Payment Initiation
      • Create QR Code (Static, Dynamic)
      • Create Hybrid QR Code
        • Create Extension for QR Code by ID
    • Payment Cancellation
      • Cancel Active QR (Static, Dynamic)
      • Cancel Active QR Extension (Hybrid)
    • Payment Refund
      • Refund Completed Payment
    • Information Retrieval (GET)
      • Display List of QR Codes with Filtering Options
      • Retrieve QR Details by ID
      • Retrieve List of Payments with Filtering Options
      • Retrieve Payment Details by ID
  • Payment Simulation (Sandbox)
  • Notifications on Callback URL
  • Errors
    • API Errors
    • HTTP Status Codes
  • Glossary
  • maib e-commerce API
Powered by GitBook
On this page
  1. Overview

General Technical Specifications

This section includes the basic information required for proper integration and usage of the API.

PreviousOverviewNextMIA QR Types

Last updated 1 day ago

Request Structure

All interactions with the API are performed via HTTPS requests, with data in JSON format. Responses are also returned in JSON format.

Available Base URLs

Environment
Base URL

PROD

https://api.maibmerchants.md

TEST (Sandbox)

https://sandbox.maibmerchants.md

It is recommended to perform initial testing in the sandbox environment before requesting access to the production environment.

Authentication

Authentication is done via a Bearer token, obtained in advance. The token must be included in the header of each request:

Authorization: Bearer {access_token}

For details on how to obtain the token, refer to the section.

Data Format

  • Accepted format: application/json

  • Datetime fields must follow the ISO 8601 format (example: 2029-10-22T10:32:28)

  • The currency used is MDL (Moldovan Leu)

HTTP Response Codes For the full list of HTTP response codes, see the HTTP Status Codes section.

Code
Meaning

200

Valid request, response returned

400

Invalid request (structure or data error)

401

Unauthorized (missing or invalid token)

403

Forbidden (insufficient permissions)

500

Internal server error

Authentication