Webhook - Sellfern Docs

Webhook cho phép các tích hợp hướng sự kiện cho luồng công việc đơn hàng, mặt hàng, xử lý đơn và danh mục khi các endpoint webhook và sự kiện liên quan có trong Tham chiếu API V1. Các thao tác ghi quản lý webhook tuân theo cùng quy tắc an toàn ghi công khai như các endpoint mutation khác: đính kèm Idempotency-Key, retry các thất bại mạng hoặc 5xx không chắc chắn với cùng khóa, và xem 422 idempotency_conflict là dấu hiệu khóa đã được dùng lại với một thân yêu cầu khác.

Sự kiện

Các sự kiện webhook khả dụng được liệt kê trong Tham chiếu API V1. Xem các sự kiện không có trong Tham chiếu API là không khả dụng cho tích hợp công khai.

Xác minh chữ ký

Xác minh chữ ký webhook trước khi tin tưởng payload. Từ chối các sự kiện có dữ liệu chữ ký bị thiếu hoặc không hợp lệ theo lược đồ chữ ký được mô tả trong Tham chiếu API V1.

Retry chuyển phát

Nếu endpoint của bạn trả về phản hồi không phải 2xx hoặc hết thời gian chờ, Sellfern có thể retry chuyển phát. Xử lý sự kiện theo cách idempotent bằng ID sự kiện để các lần chuyển phát lặp lại không gây trùng công việc.

Payload ví dụ

{
  "id": "evt_01HX...",
  "type": "order.updated",
  "created_at": "2026-05-23T12:00:00.000Z",
  "organization_id": "org_123",
  "data": {
    "order_id": "ord_123"
  }
}

Danh sách kiểm tra an toàn

Xác minh chữ ký webhook trước khi tin tưởng payload; từ chối các sự kiện có dữ liệu chữ ký bị thiếu hoặc không hợp lệ.
Xác minh quyền sở hữu sự kiện và cô lập tổ chức trước khi thay đổi trạng thái cục bộ.
Chỉ trả về phản hồi thành công sau khi sự kiện được chấp nhận để xử lý.
Làm cho việc xử lý sự kiện trở nên idempotent trong hệ thống của bạn.
Xoay vòng bí mật webhook nếu nghi ngờ bị lộ.

Nguồn tin cậy

Sử dụng Tham chiếu API để xác nhận endpoint quản lý webhook và payload sự kiện nào sẵn sàng V1. Nếu một endpoint webhook hoặc sự kiện không có trong Tham chiếu API V1, xem nó là không khả dụng cho tích hợp công khai.

Documentation Index

​Sự kiện

​Xác minh chữ ký

​Retry chuyển phát

​Payload ví dụ

​Danh sách kiểm tra an toàn

​Nguồn tin cậy