verification.requested

페이로드

객체: EventVerificationRequested

• idstring필수

  이벤트 ID(evt_…)로, webhook-id 헤더로도 보내요. 중복 전송을 걸러 내는 데 쓰세요.

• typestring필수

  허용 값: verification.requested

• created_atstring (date-time)필수

  변경이 일어난 시각(UTC).

• org_idinteger필수
• api_versionstring필수

  data 스키마의 계약 버전.

• sequenceinteger

  웹훅 안에서의 전송 순번(테스트 이벤트에는 없어요).

• objectWebhookEventObject필수
• payloadstring필수

  thin은 data 필드가 없다는 뜻이에요: API로 객체를 읽으세요.

  허용 값: fullthin

• dataobject
  필드

  • cardEventCard필수
  • actor_idinteger | null필수

    해당 동작을 수행한 사용자. 조직 API 키나 플랫폼 자체가 수행했으면 null이에요.

  • reasonstring필수

    중립 사유 코드(값이 늘어날 수 있는 열거형이므로 알 수 없는 코드는 일반 실패로 처리하세요). 값: requested, new_verifier.

  • notestring
• testboolean필수

  POST /v1/webhooks/{webhook_id}/test로 보낸 테스트 이벤트.

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "verification.requested",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "card",
    "id": "c_9f2e41"
  },
  "payload": "full",
  "data": {
    "card": {
      "id": "c_9f2e41",
      "title": "Refund policy",
      "collection": "support",
      "collection_id": 3,
      "version": 4,
      "kind": "text",
      "status": "ready",
      "verification_state": "needs_verification",
      "owner_id": 7,
      "tags": [
        "billing"
      ],
      "external_id": null,
      "metadata": {}
    },
    "actor_id": 11,
    "reason": "requested",
    "note": "Prices changed in October"
  },
  "test": false
}