> For the complete documentation index, see [llms.txt](https://docs.maibmerchants.md/mia-qr-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maibmerchants.md/mia-qr-api/en/overview/general-technical-specifications.md).

# General Technical Specifications

#### **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:

<pre><code><strong>Authorization: Bearer {access_token}
</strong></code></pre>

For details on how to obtain the token, refer to the [**Authentication** ](#authentication)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** ](broken://pages/Y24sIVDWho1lkFa6cZRD)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                     |