Gửi lại webhook qua SePay MCP

Thao tác ghi duy nhất của SePay MCP: ứng dụng AI đề nghị gửi lại một lần gửi webhook lỗi, bạn duyệt trên my.sepay.vn trong 5 phút. Quyền cần có, cách xác nhận, cách kiểm tra lại.

||

Gửi lại webhook lỗi là thao tác ghi duy nhất của SePay MCP. Mặc định chỉ đọc. Thao tác ghi chỉ chạy khi bạn cấp quyền và xác nhận từng lần. Ứng dụng AI không tự gửi được: mỗi lần gửi lại cần bạn bấm Duyệt trên my.sepay.vn.

Thao tác ghi cho cổng thanh toán và hóa đơn điện tử chưa có trong SePay MCP.

ToolNhóm quyềnCâu hỏi mẫu
replay_webhookGửi lại webhook (có xác nhận)"Gửi lại webhook bị lỗi của đơn DH00012."

replay_webhook gửi lại một lần gửi webhook bị lỗi của một giao dịch, để web của bạn nhận lại và xác nhận đơn. Lần gọi đầu không gửi gì, chỉ trả link duyệt; webhook chỉ được gửi sau khi bạn bấm Duyệt.

Quyền cần có

  • Nhóm quyền Gửi lại webhook (có xác nhận) (mcp:webhook-log:write). Trên màn cấp quyền, nhóm này nằm riêng và không bật sẵn: bạn phải tự bật.
  • Quyền sửa nhật ký WebHooks trên SePay, đúng quyền dùng cho nút Phát lại trên web. Trang phân quyền người dùng không có ô cấp quyền sửa này, nên hiện chỉ SuperAdmin và Admin có. Tài khoản Người dùng bình thường không thấy nhóm này khi cấp quyền, kể cả khi có quyền Xem nhật ký WebHooks. Bị hạ khỏi Admin thì mọi kết nối MCP của bạn bị thu hồi. Tài khoản không còn quyền gửi lại webhook thì ứng dụng AI nhận lỗi "Tài khoản của bạn không có quyền dùng dữ liệu này."
  • Quyền theo tài khoản ngân hàng và tài khoản ảo: chỉ gửi lại được giao dịch của tài khoản ngân hàng, tài khoản ảo bạn được phân quyền. SePay kiểm lại lúc bạn bấm Duyệt. Giao dịch ngoài phạm vi đó được trả như không tìm thấy.
  • Đã tắt nhóm quyền này sau khi kết nối thì ứng dụng AI nhận lỗi "Quyền cho công cụ này hiện đang tắt. Hãy bật lại trong SePay → AI Agent → Ứng dụng đã kết nối → Chỉnh quyền, rồi hỏi lại."
  • Chỉ chạy trên production, và công ty phải đã bật tính năng gửi lại webhook. Chưa bật thì ứng dụng AI nhận thông báo "Công ty của bạn chưa được kích hoạt tính năng gửi lại webhook…".

Cách xác nhận

  1. Bạn nhờ ứng dụng AI gửi lại webhook. Ứng dụng AI gọi replay_webhook lần 1, nhận link duyệt dạng https://my.sepay.vn/ai-agent/approve/… và đưa link cho bạn.
  2. Bạn mở link trên my.sepay.vn (đang đăng nhập đúng tài khoản đã kết nối ứng dụng AI). Trang hiện thao tác, môi trường, giao dịch (số tiền, mã thanh toán, ngày) và webhook (tên, tên miền). Bấm Duyệt hoặc Từ chối trong 5 phút.
  3. Bạn báo ứng dụng AI đã duyệt. Ứng dụng AI gọi replay_webhook lần 2 với approval_id, trong 10 phút kể từ lúc bạn bấm Duyệt, và báo kết quả.

Chỉ chính người dùng đã kết nối ứng dụng AI duyệt được; đồng nghiệp mở link thì trang báo không có quyền duyệt. Mỗi link chỉ dùng được 1 lần. Kết quả ứng dụng AI nhận được:

Kết quảNghĩa
deliveredĐã gửi lại, web của bạn nhận thành công
not_deliveredĐã gửi lại, web của bạn vẫn trả lỗi (mã HTTP ở log.response_status_code)
pendingBạn chưa bấm Duyệt hay Từ chối
rejectedBạn đã bấm Từ chối, không gửi
expiredQuá 5 phút chưa duyệt, hoặc quá 10 phút sau khi duyệt mà chưa gọi lần 2; không gửi
already_usedLink này đã dùng để gửi rồi, không gửi lần nữa
request_mismatchTham số lần 2 khác lần 1, hoặc khác người dùng; không gửi
already_deliveredGiao dịch này đã được web của bạn nhận thành công trước đó; không gửi. Vẫn cần gửi lại thì dùng nút Phát lại trong lịch sử gửi webhook trên my.sepay.vn
webhook_inactiveWebhook đang tạm ngưng; bật lại trên trang Webhooks rồi tạo yêu cầu mới
filter_skipped, filter_mismatchGiao dịch không khớp bộ lọc của webhook; không gửi
limit_reachedVượt số lần gửi lại cho giao dịch này; thử lại sau retry_after_seconds giây
busyĐang có một lần gửi lại khác cho giao dịch này; thử lại sau ít phút

Cách quay lại và kiểm tra

  • Trước khi duyệt: bấm Từ chối, hoặc để link hết hạn sau 5 phút. Không có gì được gửi.
  • Sau khi đã gửi: webhook đã gửi không thu hồi được. SePay chặn gửi trùng: không gửi lại giao dịch mà web của bạn đã nhận thành công, và giới hạn số lần gửi lại mỗi giao dịch (tối đa 3 lần trong 60 phút). Web của bạn vẫn nên chống xử lý trùng theo id giao dịch, để một đơn không được cộng tiền 2 lần.
  • Không muốn ứng dụng AI gửi lại webhook nữa: tắt nhóm quyền Gửi lại webhook (có xác nhận) hoặc thu hồi kết nối của ứng dụng AI trên trang AI Agent (chi tiết).
  • Kiểm tra lại: mở tab Nhật ký hoạt động trên trang AI Agent. Mỗi yêu cầu gửi lại hiện thành một dòng riêng, tách khỏi các lượt đọc dữ liệu, ghi thao tác (ví dụ "Gửi lại webhook … cho giao dịch …"), bạn đã Duyệt hay Từ chối, và kết quả gửi.

Tiếp theo