# Integration steps

{% stepper %}
{% step %}

### 1. **Integration/testing of maib payment acceptance APIs**

Integrate your online solution with the **maib** payment acceptance APIs and perform successful testing based provided [documentation](/main/en.md). If needed, use card [test data](#user-content-fn-1)[^1] to make payments in the test environment.

You can request access data for API testing (*Project ID / Project Secret / Signature Key*) at the email address: <ecom@maib.md>, specifying the website or application for which you want to perform the integration and the type of integration.

At this stage, we also recommend verifying if your website/application meets all [integration requirements](/main/en/integration/requirements.md) and implementing any missing aspects.

After completing the tests, send the successful payment IDs (*payId*) and the website or application address to the same email address to verify the correctness of the integration.

{% hint style="info" %}
If you encounter errors or uncertainties during integration/testing, please consult the API documentation in more detail or contact the [support team](mailto:ecom@maib.md), providing as much error-related data (HTTP status code, errorCode, errorMessage, date/time of the request) and information regarding the payment solution (Project ID, Merchant name, website/app name, website URL).
{% endhint %}
{% endstep %}

{% step %}

### **2. Completion and submission of the questionnaire**

The Merchant's representative[^2] must download the questionnaire below, complete it, and submit it (together with other documents requested in the questionnaire) to the email address: <ecom@maib.md>. The questionnaire can be submitted before or during integration/testing.

{% file src="/files/bjZo30Tc9XK5rVM097J2" %}
{% endstep %}

{% step %}

### **3. Verification of compliance with requirements**

After completing the tests and submitting the questionnaire, the Bank will verify compliance with [all requirements](/main/en/integration/requirements.md) for integration with **maib**.
{% endstep %}

{% step %}

### **4. Signing the contract**

If all requirements are met and your solution's verification is successful, the Merchant Administrator[^3] will receive and sign the payment acceptance contract.

The contract can be signed in person at the branch or online with a digital signature.
{% endstep %}

{% step %}

### **5. Registration on the maibmerchants/Merchant Portal**

To register, you will need to provide the following information: website domain, your e-commerce solution platform, IP address (server/hosting) and user data who will have access to the **maibmerchants/Merchant Portal** platform (First Name Last Name, Phone, Email). The user will receive an email with a link to set the password.
{% endstep %}

{% step %}

### **6. Activation of the Production Project**

Access your Production Project, fill in all mandatory fields (*Callback URL / Ok URL / Fail URL*), and activate the Project to receive access data (*Project ID / Project Secret / Signature Key*). With this access data, you will be able to receive real payments.

Perform a transaction with a symbolic amount (10 MDL) to ensure successful integration.
{% endstep %}
{% endstepper %}

[^1]: Cardholder: Test Test

    Card number: 5102180060101124

    Exp. date: 06/28

    CVV: 760

[^2]: The administrator or other person responsible for the integration

[^3]: Or another person with the right to sign


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maibmerchants.md/main/en/integration/steps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.