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"
}
}
}

