Retry giao dịch

Hướng dẫn nghiệp vụ Retry trong hệ thống VietQR

Nghiệp vụ Retry là quá trình VietQR sẽ tự động đẩy lại thông tin biến động số dư (BĐSD) bị lỗi trước đó đến phía đối tác. Quá trình này bao gồm hai phần chính:

1. Giao dịch bị lỗi do timeout hoặc lỗi kết nối giữa hệ thống VietQR và đối tác: VietQR sẽ thực hiện retry, tức là đẩy lại thông tin BĐSD.

2. Giao dịch nhận được mã lỗi từ API Transaction-sync của đối tác: Nếu mã lỗi thuộc bộ mã lỗi yêu cầu thực hiện retry, VietQR sẽ tiến hành retry lại giao dịch.

Quy trình Retry của VietQR

• VietQR sẽ thực hiện retry thông tin BĐSD cho đến khi nhận được phản hồi thành công từ phía đối tác hoặc phản hồi với các mã lỗi không yêu cầu retry.

• Số lần retry tối đa là 10 lần. Trong phút đầu tiên, VietQR sẽ retry 5 lần. Từ phút thứ 2 trở đi, hệ thống sẽ retry mỗi phút một lần.

• Khi tích hợp nghiệp vụ retry, đối tác cần kiểm tra kỹ mã giao dịch (referenceNumber) để tránh tình trạng trùng lặp giao dịch. VietQR đảm bảo không ghi nhận giao dịch bị trùng lặp.

Các bước thực hiện tích hợp nghiệp vụ Retry

1. VietQR cung cấp một file định dạng để đối tác khai báo bộ mã lỗi.

2. Đối tác cung cấp thông tin về bộ mã lỗi của mình vào file.

3. VietQR tiến hành cấu hình tích hợp retry dựa trên bộ mã lỗi của đối tác.

4. Hai bên thực hiện kiểm thử và nghiệm thu quy trình.

5. Đối tác tiến hành golive nghiệp vụ retry.

Hướng dẫn này nhằm đảm bảo quá trình retry diễn ra suôn sẻ và tránh những lỗi không mong muốn.