Thu tiền bằng VietQR và mã DTP

~6 phút đọc

Dòng Tiền Pro không có ví và không giữ tiền: khách quét VietQR và chuyển thẳng từ ngân hàng của họ vào tài khoản nhận mà bạn chọn. Dòng Tiền Pro sinh mã QR, đặt một mã nội dung DTP vào lời chuyển khoản và khi giao dịch về, tự khớp mã để đổi yêu cầu sang Đã nhận.

Mã nội dung DTP

Mã có dạng DTP cộng sáu ký tự, ví dụ DTP7K2M9N. Năm ký tự đầu sau DTP sinh ngẫu nhiên, ký tự thứ sáu là ký tự kiểm tra để phát hiện gõ sai hoặc bị ngân hàng sửa. Mã duy nhất trên toàn nền tảng và gắn với một yêu cầu hoặc một quầy; ví dụ trong tài liệu này chỉ để minh hoạ.

Một số ngân hàng sửa lời chuyển khoản: bỏ dấu cách, thêm tiền tố, đổi chữ hoa hay cắt ngắn. Dòng Tiền Pro tìm mã ở bất cứ vị trí nào, chuẩn hoá chữ hoa, bỏ dấu cách, gạch và dấu chấm, đổi chữ O thành số 0 và chữ I, L thành số 1 rồi bắt buộc kiểm tra ký tự kiểm tra. Mã sai ký tự kiểm tra không được tự khớp mà chuyển vào danh sách việc cần xử lý để người xem.

Tạo yêu cầu thanh toán

Vào Thu tiền · VietQR, mở tab Yêu cầu thanh toán rồi bấm Tạo yêu cầu thanh toán.
Nhập số tiền, hoặc để trống để khách tự nhập. Có sẵn các mức đặt nhanh 100.000 ₫, 500.000 ₫ và 1.000.000 ₫.
Chọn hạn thanh toán: 15 phút, 1 giờ, 24 giờ (mặc định), 7 ngày hoặc tuỳ chọn tối đa 30 ngày.
Chọn tài khoản nhận. Mỗi tài khoản hiện mức tin cậy của kênh; tài khoản chỉ có SMS hoặc iOS sẽ cảnh báo rằng khoản nhận chỉ tạm tính tới khi có nguồn xác thực.
Tuỳ chọn: cho phép trả một phần, gắn quầy, ghi mã tham chiếu và ghi chú nội bộ. Tạo yêu cầu, rồi gửi mã QR hoặc đường dẫn thanh toán cho khách.

Mỗi yêu cầu có một trang thanh toán công khai tại pay.dongtien.pro cho khách mở trên điện thoại; trang tự cập nhật trạng thái sau vài giây. Chỉ sửa được yêu cầu khi còn Chờ thanh toán và chưa có giao dịch khớp, và mã nội dung không đổi khi sửa.

Trạng thái yêu cầu

Trạng thái	Ý nghĩa	Việc bạn làm
Chờ thanh toán	Chưa có giao dịch khớp mã	Có thể Nhắc khách
Tạm tính	Có tin về khoản tiền nhưng chưa xác thực	Chờ nguồn xác thực; không coi là đã nhận
Đã nhận	Giao dịch khớp mã và Đã xác thực	Không
Thiếu tiền	Đã nhận chưa đủ	Gửi phần còn lại với cùng mã
Thừa tiền	Đã nhận nhiều hơn	Xử lý chênh lệch; Dòng Tiền Pro chỉ đánh dấu, không hoàn tiền
Hết hạn	Quá hạn mà chưa nhận	Tạo lại
Đã huỷ	Bạn huỷ yêu cầu	Không

Trạng thái Đã nhận chỉ bật khi giao dịch đã xác thực. Một tin SMS đơn lẻ hoặc một giao dịch từ kênh tạm tính không đủ để chuyển sang Đã nhận, để một tấm ảnh chuyển khoản giả hoặc SMS giả không thể khiến quầy báo nhận tiền. Chuỗi số dư chỉ là kiểm tra nhất quán, không phải bằng chứng. Nhãn Đã xác thực là xác thực nguồn, không phải ngân hàng xác nhận quyết toán.

Giao dịch được xác thực muộn (ví dụ sao kê hôm sau nâng một giao dịch tạm tính) vẫn được gắn vào yêu cầu đã hết hạn nếu thời điểm chuyển tiền nằm trong hạn cộng thêm 2 phút; yêu cầu quay về Đã nhận. Tiền đến sau khi yêu cầu đã huỷ không được gắn, mà vào danh sách việc cần xử lý.

Cửa hàng, quầy và ca

Để thu tại điểm bán, vào tab Cửa hàng → quầy → ca.

Thêm cửa hàng, rồi các quầy; mỗi quầy gắn một tài khoản nhận, có thể dùng chung tài khoản với quầy khác vì mã DTP luôn phân biệt từng bill.
Quầy có hai kiểu: QR động theo bill (mỗi bill một QR có hiệu lực 10 phút theo mặc định) hoặc link thanh toán. POS gọi API tạo bill tại quầy; xem tài liệu cho nhà phát triển.
Màn hình quầy là trang toàn màn hình trên máy tính bảng, hiện một trong năm trạng thái: chờ thanh toán, đang xác thực, đã nhận, hết hạn, mất kết nối. Âm báo chỉ phát khi Đã nhận. Trạng thái "đang xác thực" không có tiếng và không in biên nhận.
Thu ngân và người duyệt ca được gán theo từng quầy.
Tab Đóng ca & đối soát đối chiếu số liệu POS với số tiền ngân hàng của ca. Người đóng ca và người duyệt ca là hai người khác nhau; ca đã chốt không mở lại.

Mẫu mã đơn riêng

Cửa hàng đã có sẵn mã đơn như OD12345678 có thể khai báo mẫu để Dòng Tiền Pro nhận ra mã đó trong nội dung chuyển khoản. Vào Cài đặt › Thu tiền › Mẫu mã đơn.

Mẫu là biểu thức chính quy kiểu RE2, ví dụ OD\d{8}; dài tối đa 128 ký tự, không dùng lookaround và tham chiếu ngược. Hệ thống kiểm tra mẫu và có ô thử với nội dung mẫu trước khi lưu.
Mỗi tổ chức bật tối đa 5 mẫu. Mã trích ra chỉ được dùng để đề xuất khớp chính xác với đúng một đơn hoặc hoá đơn đang mở; nếu có từ hai ứng viên trở lên thì không đoán.
Mẫu mã đơn chỉ là gợi ý. Nó không nâng mức tin cậy của giao dịch, không thay thế mã DTP và không bỏ qua bước duyệt đối soát, xem đối soát hoá đơn.
Mẫu đang được dùng bởi một endpoint webhook hoặc quy tắc tích hợp thì không xoá hay tắt được; hệ thống liệt kê nơi đang dùng.

Quyền khai báo mẫu thuộc Chủ sở hữu, Quản trị và Kế toán trưởng.

Lỗi thường gặp

Hiện tượng	Nguyên nhân	Cách xử lý
Yêu cầu mãi Tạm tính	Tài khoản chỉ có SMS hoặc iOS	Thêm Open API hoặc nhập sao kê
Tiền về nhưng không khớp yêu cầu	Khách đổi lời chuyển khoản, mã sai ký tự kiểm tra	Mở bộ lọc Cần xử lý và kiểm tra giao dịch
Thiếu tiền	Khách chuyển chưa đủ	Gửi phần còn lại
Quầy báo mất kết nối	Máy tính bảng mất mạng	Kiểm tra mạng; bill vẫn khớp khi kết nối lại