📖API VIETQR CALLBACK

Mô tả quy trình test tích hợp bộ dịch vụ APIs nhận Biến động số dư qua mã VietQR.

Hướng dẫn Test Kiểm thử :

Cấu trúc tài liệu và thực hiện gồm 5 phần:

1. Implement Get Token API

2. Execute Transaction Sync API

3. Call Get Token API

4. Generate VietQR Code API

5. Test Callback

Hướng dẫn thực hiện từng bước:

Bước 1: Cấu hình và kết nối API

Khách hàng cần thực hiện theo thứ tự sau:

• Bước 1 → Bước 2 → Bước 3 → Bước 4 → Bước 5

• Sau khi hoàn tất các bước trên, bắt đầu test kết nối

Quy trình cụ thể:

✅ Bắt đầu từ Bước 1 (Triển khai API Get Token)

✅ Sau đó chuyển sang Bước 2 (API Transaction Sync)

✅ Tiếp tục với Bước 3 (Call API Get Token)

✅ Sau đó thực hiện Bước 4 (API Generate VietQR Code)

✅ Cuối cùng là Bước 5 (Gọi API Test Callback)

Bước 2: Kiểm tra dữ liệu

• Kiểm tra lại dữ liệu đã cấu hình tại Bước 1 và Bước 2 để đảm bảo tính chính xác.

• Nếu có lỗi, cần chỉnh sửa trước khi tiếp tục các bước tiếp theo.

🔹 Lưu ý: Sau khi hoàn tất các bước trên, khách hàng có thể tiến hành kiểm thử toàn bộ quy trình để đảm bảo hệ thống hoạt động đúng yêu cầu

Hướng dẫn sau khi hoàn tất GOLIVE kiểm thử

✅ Sau khi test thành công, khách hàng sẽ được nghiệm thu và triển khai trên môi trường dịch vụ thực của tài khoản ngân hàng.

📌 Liên hệ bộ phận kinh doanh (Khối khách hàng Doanh nghiệp số) để hỗ trợ triển khai:

Cán bộ KD	• Mobile:	• Email:
📞 Lê Hương	0968 383 636 024 6663 3324	[e-mail] [e-mail]
📞 Đạo	0923 006 234	[e-mail]
📞 Tạ Quang Tuấn	0966 266 049	[e-mail]
📞 Hoàng Văn Hiển	0565 606 789	[e-mail]
📞 Thịnh Nguyễn	0936 381 333	[e-mail]
📞 Tuấn Phạm	0922 333 636	[e-mail]
📞 Hotline	0939 603 636	[e-mail] [e-mail]

🔹 Nếu cần thêm hỗ trợ, vui lòng liên hệ với bộ phận kinh doanh theo thông tin trên.

Mô tả chi tiết về tài liệu API

API Get Token

Các bước để nhận biến động số dư từ VietQR

(Áp dụng để đối tác đồng bộ biến động số dư do VietQR trả về)

Bước 1: Cấp quyền truy cập API

• Đối tác cần cấp quyền cho VietQR bằng cách thiết lập quyền truy cập vào API Transaction Sync.

• Cấu hình điểm nhận dữ liệu (Webhook) để VietQR có thể gửi thông tin biến động số dư.

Bước 2: Cấu hình đầu hứng (Webhook)

• Đối tác cung cấp URL endpoint để nhận dữ liệu.

• Đảm bảo endpoint hỗ trợ nhận dữ liệu từ VietQR với phương thức POST.

• Kiểm tra bảo mật, xác thực request từ VietQR.

Bước 3: VietQR gửi dữ liệu biến động số dư

• Khi có giao dịch mới, VietQR sẽ gửi thông tin biến động số dư theo thời gian thực đến webhook của đối tác.

• Dữ liệu bao gồm:

• Số tiền thay đổi

• Số dư mới

• Thời gian giao dịch

• Mã giao dịch

• Các thông tin khác tùy theo cấu hình

Bước 4: Xác nhận và xử lý dữ liệu từ VietQR

• Đối tác nhận request từ VietQR và xác thực dữ liệu.

• Lưu trữ hoặc xử lý thông tin theo nhu cầu (cập nhật vào hệ thống, hiển thị trên ứng dụng, v.v.).

• Trả về response 200 OK để xác nhận đã nhận dữ liệu thành công.

Bước 5: Kiểm tra và giám sát

• Định kỳ kiểm tra logs để đảm bảo không có lỗi kết nối.

• Nếu có lỗi (mất kết nối, dữ liệu sai, v.v.), cần kiểm tra lại cấu hình webhook hoặc liên hệ hỗ trợ từ VietQR.

👉 Lưu ý: VietQR có thể yêu cầu xác thực webhook bằng token hoặc chữ ký số để đảm bảo an toàn khi truyền dữ liệu.

API Transaction Sync

// Some code