> For the complete documentation index, see [llms.txt](https://docs.maibmerchants.md/main/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/main/en/integration/steps.md).

# 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