Giao dịch và cách khớp lệnh
Hạ Tầng đọc nội dung chuyển khoản thế nào để tìm thanh toán hay đơn hàng tương ứng, chuyện gì xảy ra khi khách quên ghi mã, và xử lý tiền về chưa khớp ra sao.
Cập nhật ngày
Trong bài này
Mọi biến động số dư ngân hàng báo về cho các tài khoản đã liên kết đều có ở Thanh toán → Giao dịch, dù giao dịch đó có trả cho thanh toán nào của bạn hay không. Bài này giải thích Hạ Tầng xác định một giao dịch thuộc thanh toán hay đơn hàng nào, và cần làm gì với những giao dịch không xác định được.

Danh sách hiển thị gì
| Cột | Ý nghĩa |
|---|---|
| Ghi sổ | Thời điểm ngân hàng ghi nhận giao dịch |
| Mô tả | Nội dung chuyển khoản như ngân hàng báo |
| Mã | Mã thanh toán hoặc mã đơn của bạn tìm thấy trong nội dung |
| Số tiền | + là tiền vào, - là tiền ra |
| Khớp | Đã khớp khi giao dịch trả cho một thanh toán của bạn; Chưa khớp trong các trường hợp còn lại |
| Nguồn | Cách Hạ Tầng biết giao dịch: push (ngân hàng thông báo), reconcile (đọc từ lịch sử tài khoản), import (sao kê bạn nhập) hoặc simulator (môi trường thử nghiệm) |
| Mã tham chiếu | Số tham chiếu của ngân hàng |
Lọc bằng Tiền vào, Tiền ra, Đã khớp và Chưa khớp.
Một giao dịch được khớp thế nào
Khi có giao dịch, Hạ Tầng đọc nội dung theo thứ tự sau:
- Làm sạch nội dung. Bỏ dấu,
đthànhD, chuyển hết sang chữ hoa và bỏ mọi khoảng trắng, dấu câu.ck htbf7rdgvq - cảm ơnthànhCKHTBF7RDGVQCAMON. - Tìm mã thanh toán. Mã tự sinh gồm tiền tố của bạn (mặc định
HT) và 8 ký tự chữ, số không bao giờ có0,O,1hayI, để khách chép tay không nhầm. Nếu nội dung đã làm sạch chứa mã của một thanh toán đang mở trên tài khoản đó, giao dịch trả cho thanh toán đó. - Tìm mã riêng của bạn. Nếu bạn đặt mã chuyển khoản riêng cho thanh toán (ví dụ
DH000016), Hạ Tầng tìm mã đó ở bất kỳ vị trí nào trong nội dung. Khi mã này nằm trong mã kia (DH1002vàDH10024), mã dài hơn được ưu tiên. - Tìm theo định dạng mã đơn. Nếu tài khoản có cài Mã đơn riêng của bạn (ví dụ
DHvà 6 chữ số), Hạ Tầng ghi lại mã đơn tìm thấy, kể cả khi không có thanh toán nào cho mã đó, và chuyển cho hệ thống của bạn.
Kết quả:
- Giao dịch trả cho một thanh toán: giao dịch Đã khớp, thanh toán chuyển sang Đã thanh toán, Thanh toán một phần hoặc Thanh toán dư, và website của bạn được báo.
- Không khớp thanh toán nào: giao dịch Chưa khớp, mã đơn tìm thấy (nếu có) nằm ở cột Mã. Hệ thống của bạn vẫn được báo, nên cửa hàng chỉ dùng mã đơn vẫn xác nhận được đơn.
- Một giao dịch không bao giờ bị tính hai lần: nếu ngân hàng báo lại cùng giao dịch (cùng mã tham chiếu và số tiền trên tài khoản), lần sau bị bỏ qua.
Khi khách quên ghi mã
Giao dịch về ở trạng thái Chưa khớp và cột Mã trống. Cách xử lý:
- Tìm đơn hàng: so số tiền, thời gian và tên người chuyển (hiện ở Đối soát hoá đơn, cột Người chuyển). Hỏi khách nếu cần.
- Mở thanh toán ở Thanh toán → Thanh toán và bấm Đánh dấu đã thanh toán, kèm ghi chú như
CK thiếu mã, ref FT2610....
Thanh toán chuyển sang Đã thanh toán, và website của bạn được báo như thường lệ.
| Tình huống | Bạn thấy | Cần làm |
|---|---|---|
| Khách quên ghi mã | Chưa khớp, không có mã | Tìm đơn và Đánh dấu đã thanh toán |
| Chuyển sai số tiền | Thanh toán Thanh toán một phần hoặc Thanh toán dư | Nhờ khách chuyển nốt, hoặc hoàn phần dư từ ngân hàng |
| Chuyển hai lần | Hai giao dịch; thanh toán Thanh toán dư | Hoàn tiền từ ngân hàng |
| Chuyển sau khi thanh toán hết hạn | Thanh toán vẫn chuyển sang Đã thanh toán | Tự quyết có giao hàng hay không |
| Chuyển nhầm sang tài khoản khác | Không thấy gì: Hạ Tầng chỉ đọc tài khoản đã liên kết | Kiểm tra lại với khách |
| Có trong app ngân hàng nhưng không có ở đây | Ngân hàng không báo về | Nhập sao kê của ngày đó |
Cửa hàng chỉ dùng mã đơn của mình
Cửa hàng có QR in sẵn tại quầy, hoặc hệ thống đã có mã đơn riêng, không cần tạo thanh toán cho từng đơn. Hãy cài Mã đơn riêng của bạn cho tài khoản (ví dụ tiền tố DH, 6 chữ số) ở Cài đặt thanh toán → Tài khoản ngân hàng → Khớp lệnh và thông báo. Mọi giao dịch mang mã như vậy sẽ được báo tới hệ thống của bạn kèm mã tìm thấy, để đối chiếu với đơn ở phía bạn. Lập trình viên có thể tạo VietQR điền sẵn mã đơn trong nội dung; xem Nhận chuyển khoản không cần đơn hàng.
Thử ở môi trường thử nghiệm
Ở môi trường thử nghiệm, khung giả lập ở đầu trang Giao dịch gửi một giao dịch vào tài khoản giả lập với số tiền và nội dung tuỳ ý, không cần thanh toán, như khách trả theo mã đơn của bạn. Bấm Giả lập sau khi thử nội dung DH123456 thanh toan khi đã cài định dạng mã đơn, hoặc nội dung không có mã nào.
Bước tiếp theo
Bài viết này có giúp ích cho bạn không?
Bài viết liên quan
- Tạo và theo dõi thanh toánTạo thanh toán có VietQR và mã chuyển khoản riêng, gửi cho khách, rồi theo dõi tới khi đã thanh toán, thanh toán một phần, thanh toán dư hay hết hạn.
- Liên kết tài khoản ngân hàngKết nối tài khoản ngân hàng nhận tiền của khách (MB Bank, BIDV, ACB hoặc qua Pay2S) để Hạ Tầng thấy từng giao dịch, và khôi phục giao dịch bị sót bằng sao kê.
- Đối soát tiền vào với hoá đơnXem những khoản chuyển vào tài khoản còn thiếu hoá đơn điện tử, xuất bổ sung, và đánh dấu tiền hoàn hay chuyển nội bộ là không cần hoá đơn.
Chưa tìm thấy điều bạn cần?
Đội ngũ của chúng tôi trả lời qua chat, bằng tiếng Việt hoặc tiếng Anh.
Bạn đang tích hợp API hoặc SDK? Xem tài liệu cho lập trình viên →