4️Merchant Connection Declaration

You need to declare the necessary information to connect your merchant account with VietQR.

Declaring Connection Information

1. Access the connection declaration page here.

2. Enter the required information: Fill out all the necessary fields.

3. Test the connection: Click the "Test Get Token" button to verify that the token retrieval works correctly.

4. Contact our technical department: After completing the declaration, reach out to our technical team for further assistance.

Notes:

• The URL or IP + Port needs to be declared from your side.

• Currently, we support linking with MB and BIDV banks. Other banks are in the process of being implemented shortly.

---

Notifications to VietQR Technical Department

1. Ensure that our technical team has received the connection information and the necessary guidelines to begin integration. (When contacting us, please resend the Merchant Name you declared.)

2. After receiving the information, we will verify and approve the connection.

Once this step is completed, VietQR will provide you with a username and password to access VietQR APIs in the Test environment.

---

FAQs

What information do I need to declare to connect my merchant to VietQR?

You need to declare the URL or IP + Port that your system will use to connect to the VietQR service. Ensure that this information is accurate and thoroughly checked.

Can I change the declared information after completing the declaration?

Yes, you can change the declared information. However, after making changes, you need to re-test by clicking "Test Get Token" to ensure that the connection is still functioning correctly.

What should I do if I encounter an error when performing the "Test Get Token"?

If you encounter an error during "Test Get Token," check the declared information such as URL, IP, and Port. Ensure that your system can communicate with VietQR. If the issue persists, contact VietQR's technical department for support.

Why is the Test Get Token step important?

This step verifies that your system can successfully retrieve a token from VietQR's API, ensuring that the connection is working correctly before proceeding with further integration steps.

Can I use any URL or IP + Port to declare?

No, you must use the URL or IP + Port that your system will actually use to connect to VietQR. This information must be accurate and suitable for your environment.

Which banks does VietQR support for account linking?

Currently, VietQR supports linking accounts with MB and BIDV banks. Other banks will be supported in the near future.

Why do I need to contact VietQR's technical department after declaring?

Contacting VietQR's technical department ensures they have received your connection information and can proceed to verify and approve the connection. This is a crucial step for integrating the service.

When will I receive a username and password to access VietQR APIs?

After VietQR's technical department verifies and approves your connection, they will provide you with a username and password to access VietQR APIs in the Test environment.