Skip to main content
checkout.pending is off by default. It will not be delivered until you enable it in Dashboard → Developers. See Receiving Webhooks for instructions.

Payload Structure

Example Payload

Handling Pending Events

When a charge enters a pending state, you should:
  • Update your system to reflect that the transaction is in progress
  • Display appropriate pending status to the customer
  • Wait for the subsequent charge event (checkout.succeeded, checkout.failed, checkout.returned or, on some rails, checkout.cancelled). A pending charge is not resolved by checkout expiry: the checkout has already completed from the customer’s point of view.
  • Do not assume the transaction has completed until you receive a final status event
The transaction_type field in the charge object indicates the type of transaction:
  • credit: Represents money being added to the customer’s account
  • debit: Represents money being removed from the customer’s account