Webhook

✧ Mở bằng AI

Sao chép tài liệu, mở AI rồi dán vào cuộc trò chuyện.

Nhận thông báo giao dịch tại máy chủ của phần mềm sau khi khách cấp quyền. Không cần khai báo Webhook URL khi đăng ký ứng dụng; dev truyền địa chỉ HTTPS khi gọi API tạo webhook. App cũ có danh sách URL cố định vẫn giữ giới hạn đã cấu hình.

Các thao tác

Thao tác	Method	Quyền
Danh sách webhook	GET	webhooks:read
Tạo webhook	POST	webhooks:write
Bật / tắt webhook	PATCH	webhooks:write
Xóa webhook	DELETE	webhooks:delete

Mỗi trang có tham số, response và nút Thử API mở đúng thao tác trong Playground.

Luồng tích hợp

Khách cấp quyền webhook và chọn ngân hàng.
Gọi API tạo webhook với bank_id, URL HTTPS nhận giao dịch, hướng giao dịch và request_key riêng.
Lưu signing_secret được trả trong lần tạo đầu tiên tại backend.
Khi nhận request, xác minh chữ ký webhook trên raw body trước khi xử lý, chống trùng và trả HTTP 2xx khi tiếp nhận thành công.

Webhook chịu điều kiện gói dịch vụ, hạn mức và ngân hàng hiện có. Thu hồi kết nối hoặc khóa app sẽ dừng chuyển tiếp. URL nhận phải là địa chỉ công khai; backend chặn IP nội bộ và không đi theo redirect.