Tích hợp Webhook tùy chỉnh vào Casso

Casso cho phép tích hợp với một Webhook API gọi tới server của bạn. Mỗi khi có giao dịch mới, Casso sẽ thực hiện gọi tới API bạn đã thiết lập sẵn để gửi thông tin giao dịch này.

Thời gian trung bình từ lúc giao dịch phát sinh bên ngân hàng tới lúc Webhook được gọi là 5 phút.

Cấu hình Webhook URL tùy chỉnh trong Casso

1/ Truy cập vào Thiết lập > Tích Hợp > Custom Webhook API 2/ Nhập URL Webhook của bạn vào mục Webhook URL, Sau đó click ra bên ngoài để thay đổi có hiệu lực.

Cấu trúc dữ liệu gửi qua Webhook

Dữ liệu có cấu trúc như sau

        "id": 
        "tid": Mã giao dịch từ phía ngân hàng            
        "description": Nội dung giao dịch            
        "amount": 500, Số tiền giao dịch            
        "cusum_balance": Số tiền còn lại sau giao dịch                             
        "when": Thời gian ghi có giao dịch ở ngân hàng            
        "bank_sub_acc_id": Mã tài khoản ngân hàng mà giao dịch thuộc về 

Bảo mật giao dịch

Để xác thực Casso đã gọi webhook API, chúng tôi đề xuất cách thức bạn sẽ tạo một key bảo mật, mỗi gọi gọi vào Webhook API, Casso sẽ đính kèm Key bảo mật này vào trong header, Bạn có thể kiểm tra header lấy thông tin key bảo mật để xác thực việc gọi vào Webhook API hợp lệ.

Key bảo mật sẽ được lưu trong trường Secure-Token Trong header của Webhook API

Bạn có thể dùng pipedream.com để debug dữ liệu gọi vào Webhook URL tùy chỉnh

Tra soát toàn bộ giao dịch

Trong trường hợp có phát sinh lỗi dẫn tới giao dịch chuyển về qua Webhook bị sót. Bạn có thể thực hiện việc gọi API để lấy về toàn bộ giao dịch trong một khoảng thời gian cụ thể để tra soát.

Tài liệu API lấy danh sách giao dịch : Đang cập nhật

Tích hợp hệ thống tự động xác nhận thanh toán

Mẹo : Sử dụng các tài khoản ngân hàng nhận tiền như : Vietcombank , TPbank, TimoPlus để nhận được giao dịch nhanh và ổn định nhất