2️Khai báo merchant connection

Bạn cần khai báo các thông tin cần thiết để kết nối merchant của mình với VietQR.

Khai báo thông tin kết nối

Đăng nhập đường link để khai báo kết nối tại đây : https://vietqr.vn/merchant/request

hoặc gửi thông tin yêu cầu khởi tạo môi trường test về địa chỉ email : [e-mail] với các thông tin như sau 👍

ác thông tin cần thiết để thiết lập kết nối API nhằm tạo môi trường test cho hệ thống. Vui lòng điền đầy đủ các tham số sau:

1.	Địa chỉ kết nối (URL/IP + PORT):
•	URL: [Vui lòng điền URL kết nối]
•	IP + PORT: [Nếu không sử dụng URL, vui lòng cung cấp địa chỉ IP và PORT]
2.	URL Path:

[Vui lòng nhập đường dẫn cụ thể của API] 3. Địa chỉ KH (mã khách hàng, không dấu): [Cung cấp địa chỉ khách hàng/mã KH để tránh trùng lặp] 4. Ngân hàng thụ hưởng: [Vui lòng chọn ngân hàng từ danh sách hoặc nhập tên ngân hàng thụ hưởng] 5. Thông tin tài khoản MB Bank (nếu có): • Số tài khoản: [Vui lòng nhập số tài khoản MB Bank] • Tên chủ tài khoản: [Vui lòng nhập tên chủ tài khoản không dấu] 6. Basic Authentication: • Username: [Vui lòng nhập tên đăng nhập] • Password: [Vui lòng nhập mật khẩu] MB 3888831389 Truong Hiep HungMB 3888831389 Truong Hiep Hung

Sau khi điền đầy đủ thông tin, vui lòng gửi lại để chúng tôi có thể tiến hành tạo môi trường test và kiểm tra kết nối.

1. Truy cập trang khai báo kết nối tại đây.

2. Nhập các thông tin cần khai báo.

3. Nhấn nút Test Get Token kiểm tra việc lấy token để đảm bảo kết nối hoạt động đúng cách.

4. Sau khi khai báo hoàn tất, hãy liên hệ đến bộ phận kỹ thuật của chúng tôi.

Lưu ý:

• URL hoặc IP + Port cần khai báo là của phía quý khách.

• Hiện chúng tôi đang hỗ trợ liên kết tài khoản ngân hàng MB và BIDV. Danh sách các ngân hàng khác đang được triển khai trong thời gian sắp tới.

---

Thông báo bộ phận kỹ thuật của VietQR

1. Hãy đảm bảo rằng đội kỹ thuật của chúng tôi đã nhận được thông tin kết nối và hướng dẫn cần thiết để bắt đầu tích hợp. (Khi liên hệ với chúng tôi, hãy gửi lại Merchant Name (tên đại lý) đã khai báo).

2. Sau khi tiếp nhận thông tin, chúng tôi sẽ kiểm tra và duyệt kết nối.

Sau khi hoàn thành bước này, VietQR sẽ cung cấp lại cho quý khách username và password để truy cập đến các API của VietQR trên môi trường Test.

---

Các câu hỏi thường gặp

Tôi cần khai báo những thông tin gì để kết nối merchant với VietQR?

Bạn cần khai báo URL hoặc IP + Port mà hệ thống của bạn sẽ sử dụng để kết nối với dịch vụ VietQR. Đảm bảo rằng các thông tin này chính xác và đã được kiểm tra kỹ lưỡng.

Tôi có thể thay đổi thông tin khai báo sau khi đã hoàn tất không?

Có, bạn có thể thay đổi thông tin khai báo. Tuy nhiên, sau khi thay đổi, bạn cần phải thực hiện lại bước kiểm tra bằng cách nhấn "Test Get Token" để đảm bảo rằng kết nối vẫn hoạt động chính xác.

Nếu tôi gặp lỗi khi thực hiện bước "Test Get Token", tôi nên làm gì?

Nếu bạn gặp lỗi khi thực hiện "Test Get Token", hãy kiểm tra lại các thông tin khai báo như URL, IP, và Port. Đảm bảo rằng hệ thống của bạn có thể giao tiếp với VietQR. Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với bộ phận kỹ thuật của VietQR để được hỗ trợ.

Tại sao việc Test Get Token lại quan trọng?

Bước này giúp xác nhận rằng hệ thống của bạn có thể lấy token thành công từ API của VietQR, đồng thời đảm bảo rằng kết nối hoạt động đúng cách trước khi tiến hành các bước tích hợp tiếp theo.

Tôi có thể sử dụng bất kỳ URL hoặc IP + Port nào để khai báo không?

Không, bạn cần sử dụng URL hoặc IP + Port mà hệ thống của bạn sẽ thực sự sử dụng để kết nối với VietQR. Các thông tin này phải chính xác và phù hợp với môi trường của bạn.

VietQR hỗ trợ những ngân hàng nào cho việc liên kết tài khoản?

Hiện tại, VietQR hỗ trợ liên kết tài khoản với ngân hàng MB và BIDV. Các ngân hàng khác sẽ được hỗ trợ trong thời gian tới.

Tại sao tôi cần liên hệ với bộ phận kỹ thuật của VietQR sau khi khai báo?

Liên hệ với bộ phận kỹ thuật của VietQR giúp đảm bảo rằng họ đã nhận được thông tin kết nối của bạn và có thể tiến hành kiểm tra, duyệt kết nối. Đây là bước quan trọng để tiến hành tích hợp dịch vụ.

Khi nào tôi sẽ nhận được username và password để truy cập API của VietQR?

Sau khi bộ phận kỹ thuật của VietQR kiểm tra và duyệt kết nối của bạn, họ sẽ cung cấp lại username và password để bạn có thể truy cập các API của VietQR trên môi trường Test.