Dữ liệu chạy qua đâu?
- payments 1. Khách quét VietQR Chuyển tiền vào tài khoản của bạn
- sync_alt 2. SePay / Casso Ghi nhận biến động số dư
- bolt 3. ThuBill nhận tin Khớp mã bill, đổi trạng thái
- receipt_long 4. Xuất hóa đơn Gửi khách qua email hoặc Zalo
Lấy địa chỉ nhận tin và khóa xác thực
Đăng nhập ThuBill bằng tài khoản quản trị, vào Cài đặt > Tích hợp > Kết nối ngân hàng. Tại đây có hai thông tin cần sao chép, mỗi workspace có bộ riêng.
https://api.thubill.com/v1/webhooks/bank-notify/org_XXXXX_live
tb_sec_••••••••••••••••••••
infoHai giá trị trên chỉ là ví dụ. Bạn phải sao chép giá trị thật trong workspace của mình, đừng dùng lại đoạn ở đây.
Khai báo địa chỉ nhận tin trên cổng trung gian
Mở trang quản trị của cổng bạn đang dùng. Bạn chỉ cần làm theo một trong hai cột dưới đây, tùy cổng đã chọn.
Trên SePay
- Vào mục Cấu hình Webhook.
- Bấm Thêm webhook mới.
- Dán địa chỉ nhận tin đã lấy ở bước 1.
- Kiểu xác thực chọn API Key / Bearer, dán khóa xác thực vào.
- Tích chọn sự kiện giao dịch tiền vào.
Trên Casso
- Vào Tài khoản > Thiết lập tích hợp.
- Chọn thẻ Webhook, bấm Tạo mới.
- Dán địa chỉ nhận tin của ThuBill vào ô endpoint.
- Tích chọn tài khoản ngân hàng cần theo dõi.
- Lưu lại và bật trạng thái sang Hoạt động.
Cách ThuBill khớp tiền vào đúng bill
Để biết khoản tiền vừa vào là của bill nào, ThuBill đọc nội dung chuyển khoản. Khi bạn tạo mã VietQR trong ThuBill, nội dung này được điền sẵn nên khách không phải gõ tay.
TB <MÃ_BILL>
Ví dụ: TB BILL9281 hoặc TB DH100293
Khớp thẳng vào bill, không cần thao tác thêm.KH <MÃ_KH> NOP TIEN
Ví dụ: KH CTYA NOP TIEN
Cộng vào công nợ của khách, bạn chọn bill sau.| Nội dung chuyển khoản | Ví dụ | ThuBill làm gì | Thứ tự ưu tiên |
|---|---|---|---|
| Có mã bill | BILL*, HD*, ORD* |
Khớp đúng bill và đổi sang “đã thanh toán” | 1 |
| Có số điện thoại khách | 09*, 08*, 03* |
Tìm hồ sơ khách rồi gửi thông báo xác nhận | 2 |
| Không theo quy ước | Nội dung tự do |
Đưa vào mục “chờ xử lý” để kế toán gán tay | Dự phòng |
Chạy thử một giao dịch trước khi dùng thật
Lưu xong cấu hình, hãy thử một lượt để chắc chắn luồng chạy đúng trước khi giao cho đội bán hàng dùng.
- 1Trong ThuBill bấm Gửi tín hiệu kiểm thử. Kết quả trả về phải là
HTTP 200 OK. - 2Chuyển khoản thật một khoản nhỏ, ví dụ 10.000đ, với nội dung
TB TEST01. - 3Màn hình ThuBill hiện thông báo “Tiền về +10.000đ” và giao dịch chuyển sang đã khớp.
Đây là ảnh minh họa thông báo bạn sẽ thấy trong ThuBill.
helpLỗi thường gặp và cách xử lý
Tiền đã về ngân hàng nhưng ThuBill chưa đổi trạng thái?expand_more
Thường là do khách chuyển khoản quên ghi nội dung hoặc gõ sai mã bill. Cách xử lý:
- Vào Đối soát > Giao dịch chưa khớp.
- Tìm đúng số tiền và thời điểm, bấm Gán vào bill rồi chọn bill tương ứng.
- Hệ thống lưu lại ai gán và gán lúc nào để sau này còn tra.
Có nhiều tài khoản ở nhiều ngân hàng thì nối cùng lúc được không?expand_more
Được. Bạn thêm từng tài khoản vào SePay hoặc Casso rồi trỏ chung về một địa chỉ nhận tin của ThuBill. Mọi giao dịch sẽ gom về cùng một sổ.
Kết nối này có rủi ro bị chuyển tiền đi không?expand_more
Không. Kết nối chỉ đọc lịch sử giao dịch. Muốn chuyển tiền khỏi tài khoản ngân hàng thì phải có chữ ký số, Smart OTP hoặc token của chính chủ tài khoản, những thứ mà luồng đọc biến động số dư không chạm tới.
Đổi hoặc hủy kết nối sau này thì làm thế nào?expand_more
Bạn vào trang quản trị SePay hoặc Casso tắt webhook là luồng dừng ngay. Dữ liệu bill và lịch sử đối soát đã ghi trong ThuBill vẫn giữ nguyên.
Kết nối xuất hóa đơn điện tử MISA meInvoice hoặc Viettel S-Invoice
Sau khi tiền đã khớp, cấu hình để ThuBill tự phát hành hóa đơn mà kế toán không phải nhập lại.
Ý kiến bạn đọc