Skip to main content

Payload Structure

interface WebhookEvent {
  event_id: string;
  type: "checkout.review.declined";
  data: {
    id: string; // id of the checkout
    type: "deposit" | "withdrawal";
    review: {
      id: string; // review ID
      status: "declined";
      decline_reason: string | null;
      reviewed_at: string;
      created_at: string;
      amount_cents: number;
    };
    customer: {
      id: string;
    };
  }
}

Example Payload

{
  "event_id": "ev_dAqWJVsmuQiHeaTndUvtNHSjaeDtLodM",
  "type": "checkout.review.declined",
  "data": {
    "id": "chk_HAgFjmvHHvhyf8ysPDNR2a5xTB4Gxe19",
    "type": "withdrawal",
    "review": {
      "id": "cpilr_qfrfXSHPGJ48SDSmcydcVsxYj5WTpMNG",
      "status": "declined",
      "decline_reason": "Suspicious activity",
      "reviewed_at": "2026-04-08T15:00:00Z",
      "created_at": "2026-04-08T14:30:00Z",
      "amount_cents": 5000
    },
    "customer": {
      "id": "cus_v2XRk6fdyxeH9nfekkFYpTJLCfupMFWi"
    }
  }
}