Tích hợp thanh toán Casso, SePay

Kết nối Casso hoặc SePay (VietQR) để Deplao nhận thông báo ngay khi tài khoản ngân hàng có giao dịch mới. Mỗi thông báo kích hoạt các workflow có bước Khi nhận thanh toán: tự báo cho nhân viên, ghi sổ Google Sheets… thay vì ngồi soát sao kê.

#Nền tảng hỗ trợ

#Địa chỉ Internet để nhận thông báo

Deplao chạy trên máy bạn, còn Casso / SePay ở trên Internet nên cần một địa chỉ Internet trỏ về máy. Mọi cấu hình địa chỉ nằm ở một chỗ: Cài đặt → Internet & Đám mây → Địa chỉ Internet, mục Cách tạo địa chỉ:

• Cloudflare tự động (khuyên dùng, cần kết nối tài khoản Cloudflare có tên miền): địa chỉ cố định, không đổi khi khởi động lại, chỉ dán vào Casso / SePay một lần. Bật Tự bật khi mở app để mở Deplao là nhận được ngay.
• Địa chỉ tạm: không cần tài khoản (dạng https://….trycloudflare.com) nhưng đổi mỗi lần khởi động lại, phải dán lại vào Casso / SePay. Chỉ nên dùng thử.
• ngrok / Cloudflare thủ công: chỉ áp dụng cho Nhân viên và API; địa chỉ nhận thanh toán vẫn là địa chỉ tạm.
• Trong bảng địa chỉ của từng dịch vụ, bật dòng Thanh toán, tích hợp. Trừ Cloudflare tự động, dòng này không tự bật khi mở app: mở lại Deplao thì bật lại.

Chi tiết từng cách tạo địa chỉ: xem Internet & Đám mây.

#Cách kết nối

1. Kết nối Casso hoặc SePay: Công cụ → Tích hợp → tab Thanh toán → chọn Casso hoặc SePay. Dán API Key, bấm Kết nối rồi Test kết nối.
2. Bật địa chỉ nhận: ngay trong trang Casso / SePay, mục Địa chỉ nhận webhook: thẻ báo Chưa bật thì bấm Bật ở Cài đặt → và bật dòng Thanh toán, tích hợp.
3. Sao chép đúng địa chỉ: quay lại trang Casso / SePay, bấm nút sao chép ở thẻ Địa chỉ nhận webhook của Casso (hoặc SePay). Địa chỉ này đã gồm đường dẫn riêng /webhook/… của kết nối; đừng dùng dòng "URL local" (chỉ dùng trong máy).
4. Dán vào Casso / SePay: trong trang quản trị Casso / SePay, mở phần cấu hình webhook, dán địa chỉ vừa chép làm địa chỉ nhận rồi lưu.
5. Chạy thử: tạo và bật một workflow có bước Khi nhận thanh toán (ví dụ bên dưới), chuyển khoản thử một khoản nhỏ rồi xem Lịch sử chạy của workflow. Góc phải trang Tích hợp phải báo Đang nhận webhook.

#Dùng trong Workflow & hội thoại

• Khi nhận thanh toán (nhóm Kích hoạt): chạy mỗi khi có giao dịch; lọc được theo Số tiền tối thiểu (VNĐ) và Nội dung CK chứa từ khóa. Dữ liệu chèn vào các bước sau (nút Chèn biến): Số tiền, Nội dung chuyển khoản, Ngân hàng, Số tài khoản, Mã giao dịch, Thời gian giao dịch.
• Lấy lịch sử giao dịch (nhóm Thanh toán): lấy các giao dịch gần nhất từ Casso hoặc SePay để dùng ở bước sau.
• Trong hội thoại: Tích hợp nhanh (nút mắt xích trên thanh tiêu đề) → Casso / SePay → Lịch sử giao dịch để xem nhanh giao dịch gần nhất khi khách báo đã chuyển khoản.

#Ví dụ: có tiền vào → ghi sổ + báo nhóm nội bộ

1. Khi nhận thanh toán: vd. Nội dung CK chứa từ khóa "DH" để chỉ bắt chuyển khoản cho đơn hàng.
2. Ghi thêm dòng mới (Google Sheets): thời gian, số tiền, nội dung chuyển khoản.
3. Gửi tin qua Telegram hoặc Gửi tin nhắn vào nhóm Zalo nội bộ (chọn ở ô Gửi đến hội thoại): báo số tiền và nội dung vừa nhận.

#Lưu ý

• Deplao phải đang mở và địa chỉ Thanh toán, tích hợp đang chạy thì mới nhận được thông báo.
• Thông báo chuyển khoản không cho biết khách nào trên Zalo / Facebook. Bước Gửi tin nhắn sau "Khi nhận thanh toán" phải chọn sẵn hội thoại nhận (vd. nhóm nội bộ).
• Dùng địa chỉ tạm: mỗi lần mở lại Deplao phải bật lại địa chỉ và dán địa chỉ mới vào Casso / SePay. Muốn cố định, dùng Cloudflare tự động.
• Mỗi kết nối có đường dẫn riêng; xoá kết nối rồi tạo lại thì đường dẫn đổi: nhớ dán lại vào Casso / SePay.
• Máy nhân viên không cấu hình địa chỉ Internet: địa chỉ nhận thanh toán do máy chủ quản lý.
• Không thấy workflow chạy? Kiểm tra: trang Tích hợp báo "Đang nhận webhook", địa chỉ trong Casso / SePay khớp địa chỉ đang hiện, workflow đã bật.