Webhook 요청 헤더
모든 Webhook 요청에 포함되는 공통 헤더와 서명 정보를 설명합니다.
공통 헤더
| 필드 | 타입 | 필수 | 제한 | 예시 |
|---|---|---|---|---|
Apiacc-Webhook-Id이벤트를 전송한 Webhook 엔드포인트의 ID입니다. | string | 필수 | — | "wh_abc123" |
Apiacc-Timestamp서명에 포함되는 Unix 타임스탬프(초)입니다. | string | 필수 | — | "1755230400" |
Apiacc-Event-Id전송된 이벤트의 ID입니다. 요청 본문의 id 값과 같습니다. | string | 필수 | — | "evt_9f8e7d6c" |
Apiacc-Signaturetimestamp, event id, raw body로 계산한 HMAC-SHA256 서명입니다. | string | 필수 | — | "v1=5f8a1c..." |
요청 예시
실제 HTTP 요청은 다음과 같은 형태로 전송됩니다.
HTTP
POST /webhooks/bank HTTP/1.1
Host: my-service.com
Content-Type: application/json
Apiacc-Webhook-Id: wh_abc123
Apiacc-Timestamp: 1755230400
Apiacc-Event-Id: evt_9f8e7d6c
Apiacc-Signature: v1=5f8a1c9b3d7e4f2a1b6c8d9e0f1a2b3c
{
"id": "evt_9f8e7d6c",
"type": "charge.approved",
"created_at": "2026-08-15T03:01:13Z",
"data": { "charge_id": "chg_example123", "amount": 10000, "platform": "default", "status": "approved" }
}엔드포인트는 기본 설정 기준 3초 이내에 응답해야 합니다. 시간이 오래 걸리는 처리는 즉시 200을 반환한 뒤 비동기로 처리하세요.