GOCheap Developers
API ReferenceWebhooks

Gửi sự kiện thử

POST
/webhooks/{webhook_id}/test-event

Gửi ngay một sự kiện webhook.test có chữ ký thật tới URL, trả lại kết quả lần gửi đó. Lần gửi thử không được gửi lại khi lỗi.

Authorization

ApiKeyAuth
headerAuthorization<token>

Authorization: ApiKey <key>. Key sandbox bắt đầu bằng gc_test_, production bằng gc_live_. Key chỉ hiện một lần lúc tạo. Không dùng key trong app di động hay trình duyệt.

Path Parameters

webhook_id*string

Response Body

Kết quả gửi

application/json
  1. response
success*boolean
data*
Example Request
curl -X POST 'https://api-stag.gocheap.vn/open-api/v1/webhooks/string/test-event'
Example Response
{  "success": true,  "data": {    "delivery_id": "dlv_01JCQ9A2B3",    "status_code": 200,    "duration_ms": 184,    "ok": true,    "error": null  }}

Xoá webhook DELETE

Trang trước

Sự kiện trạng thái chuyến Webhook

GOCheap gửi `POST` tới URL đã đăng ký mỗi khi chuyến đổi trạng thái. **Kiểm tra chữ ký:** `X-GoCheap-Signature` = hex( HMAC_SHA256( secret, `X-GoCheap-Timestamp` + "." + raw_body ) ). So sánh bằng hàm an toàn thời gian (timingSafeEqual) và từ chối nếu timestamp lệch quá 300 giây. **Gửi lại:** không nhận được 2xx trong 10 giây thì gửi lại sau 1 phút, 5 phút, 30 phút, 2 giờ (4 lần). Một sự kiện có thể đến hơn một lần (dùng `id` để bỏ trùng) và có thể đến không theo thứ tự (so `created_at`).