checkout.review.approved - Soap

checkout.review.approved is off by default. It will not be delivered until you enable it in Dashboard → Developers. See Receiving Webhooks for instructions.

Payload Structure

interface WebhookEvent {
  event_id: string;
  data: {
    id: string; // id of the checkout
    type: "deposit" | "withdrawal";
    review: {
      id: string; // review ID, format cpilr_...
      status: "approved";
      decline_reason: null;
      reviewed_at: string; // ISO 8601
      created_at: string; // ISO 8601
      amount_cents: number;
    };
    customer: {
      id: string;
    };
    subscription: {
      id: string;
      interval: "day" | "week" | "month" | "year";
      interval_count: number;
      line_items: Array<{
        product_id: string;
        sku: string;
        product_name: string;
        product_url: string;
        quantity: number;
        price_cents: number;
        total_amount_cents: number;
      }>;
      line_items_total_amount_cents: number | null;
    } | null; // null for non-subscription checkouts
  };
  type: "checkout.review.approved";
}

Example Payload

{
  "event_id": "ev_Gv7KrD7xg2Puy7AaZ1mSLTKxTURTjPaM",
  "data": {
    "id": "chk_KpjVV7XSXqxsW7Wg17oFmqsWQy482bhb",
    "type": "withdrawal",
    "review": {
      "id": "cpilr_TfnBjgUPXvCG6KmuwxuMcRPmTFGkXm1L",
      "status": "approved",
      "decline_reason": null,
      "reviewed_at": "2026-04-08T15:00:00Z",
      "created_at": "2026-04-08T14:30:00Z",
      "amount_cents": 5000
    },
    "customer": {
      "id": "cus_Mhv5fucQqcFPhn7P8dC7GnyuMZ2R63ry"
    },
    "subscription": null
  },
  "type": "checkout.review.approved"
}

How Reviews Fit the Checkout

Review is disabled by default and enabled per account, and the criteria that route a payment to review are configured per account. Today every checkout.review.* event carries "type": "withdrawal". A review is created before the charge exists. Soap pauses the checkout instead of submitting the payment, so:

No charge exists while the review is open. No charge status can change, and you will receive no charge-based webhook for that checkout until the review is resolved.
On approval, Soap creates the charge and places the hold at that point — checkout.hold arrives then, followed by the normal withdrawal events.
On decline, no charge is ever created, so neither checkout.failed nor checkout.release_hold can fire. Reconciling only on those events will make declined withdrawals invisible to you.

Reviews are resolved by a person in the Soap dashboard. There is no timeout, no auto-approve and no auto-decline. See Checkouts, Charges and Reviews for how the entities relate.