Webhook 알림

핵심 사항

• 이벤트 처리 전에 원본 요청 본문과 엔드포인트 서명 비밀키로 HMAC-SHA256을 검증하세요.
• 이벤트 ID로 중복을 제거하고 성공 HTTP 응답을 빠르게 반환하세요. 전달 실패는 재시도되며 누락된 이벤트는 Events API에서 복구할 수 있습니다.
• payment.succeeded를 이행 근거로 사용하세요. 브라우저 복귀나 검증되지 않은 요청으로 상품을 제공하지 마세요.

예시

{
  "object": "event",
  "id": "evt_3f2a9c7e1b4d0568a2cf",
  "type": "payment.succeeded",
  "mode": "live",
  "created_at": "2026-09-21T08:31:12.114Z",
  "data": {
    "object": {
      "object": "order",
      "trade_no": "TRD_9F3A2C7E...",
      "out_trade_no": "ORD_20260921_0001",
      "amount": 2990,
      "fee": 135,
      "net_amount": 2855,
      "currency": "USD",
      "status": "paid",
      "payment_method": "card",
      "refundable_until": null,
      "metadata": { "customer_id": "cus_42" },
      "paid_at": "2026-09-21T08:31:10.882Z"
    }
  }
}