Payment controls and records

A newly enabled payment method needs later outcome notifications

Map each required outcome to both the event destination and the store action that handles it. For hosted Stripe Checkout Sessions, checkout completion alone does not establish that a delayed payment succeeded: the integration must check payment status and handle later asynchronous success or failure. A selected event type is only delivery configuration; confirm which handler reads it and what it records on the order. Keep unpaid sessions out of fulfillment and leave unobserved outcomes unverified.

For: A research-only merchant reviewing order-state handling for an asynchronous payment method on an approved processing arrangement.

Updated 2026-10-01

Identify the integration before choosing event names

Record the provider, account connection, actual payment method and checkout product used for the store. Include the installed gateway or extension and its version where relevant. A method appearing in checkout does not establish that every required downstream event has an owner. Confirm the method’s eligibility for the disclosed business separately with the provider; technical availability is not that decision.

The event names here belong to hosted Stripe Checkout Sessions. They are not a universal recipe for every Stripe plugin, Payment Element integration or another provider’s bank method. If the installed integration uses a different payment object or callback model, ask its maintainer for the required outcome events under that model before interpreting coverage. Do not add unrelated event subscriptions simply because this page names them.

Map completion, later success and later failure separately

For hosted Stripe Checkout, checkout.session.completed records checkout completion. With a delayed method, the payment can still be unresolved. Stripe’s fulfillment guidance requires checking the session payment status; an unpaid session must not be fulfilled. The buyer reaching the return page is also insufficient, because a successfully paying buyer might never reach that page.

The later Checkout outcome events are checkout.session.async_payment_succeeded and checkout.session.async_payment_failed. Record the handler and intended store action for each. Success handling needs to connect the payment outcome to the same order and apply the fulfillment decision with the payment-status check. Failure handling needs to preserve the failed outcome and identify the owner of any buyer communication or next order action. A failure notice is not authority to create a fresh charge.

Treat an existing immediate-payment path as only evidence for that path. Seeing orders progress after checkout completion does not establish what happens when a delayed payment succeeds or fails later. The missing outcome is a distinct coverage question, even if the checkout itself looks unchanged.

Check subscription, handling and saved result as separate evidence

Stripe event destinations select the account scope and event types they receive. Compare the required event list with the destination actually connected to this store. A correct event name subscribed on another account connection does not establish delivery to this order integration. Record the destination and connection without copying its signing secret.

For each outcome, obtain the maintainer’s explanation of which handler processes the event and which order reference it uses. A configured subscription does not prove that the application handles the event. Likewise, an endpoint’s 2xx response acknowledges delivery, not the completion of a later order update. Where existing real records are available, connect the event, delivery attempt, handler result and saved order state.

Stripe documents duplicate and out-of-order delivery. Ask how the existing integration avoids repeating fulfillment and how it prevents an older event from overwriting a later state. These are coverage questions for the implementation owner, not instructions to replay live events. If no real later-failure record is available, distinguish documented handling from behavior observed in orders. Do not invent a transaction or call the failure path verified.

Make the coverage decision from the open gaps

You can now identify whether the gap is an event absent from the destination selection, a selected event without confirmed handling, or handling without a traceable saved result. Give the integration owner that exact gap. If the provider still reports the payment as unresolved, the pending order may reflect the payment’s real stage; changing the store label would not settle it.

Before relying on the method to drive order state, obtain a defined action and responsible owner for completion, later success and later failure. Missing coverage remains unresolved. This page sets no settlement deadline and does not authorize sending another payment request, changing subscriptions or enabling a method on an unapproved account.

A Prism checkout consultation can start from the platform, method and outcome whose handling is unclear. Describe the work you need and the evidence already available. Prism will confirm scope, responsibilities, fees and terms before work begins; the inquiry alone does not include integration changes or establish provider eligibility.

Payment-method event coverage

Complete a separate sheet for each actual delayed method and integration. For every outcome, distinguish configured delivery, documented handler behavior and behavior observed in existing real orders. Keep an unobserved outcome unverified. Use internal references without secrets or customer payloads.

Worksheet entries are not submitted by Prism’s worksheet and are not saved by the site. Use record types, availability, anonymized observations, or match/mismatch results. Do not enter government identifiers, customer names or addresses, customer messages, receipt-access links, card or bank details, passwords, or keys. Send sensitive documents only through the provider’s verified secure channel.

Payment-method event coverage. The last column is for temporary notes.
Coverage itemEvidence to locateRequired interpretationYour coverage record
Approved payment methodProvider’s business-specific confirmation, method name and actual account connection.Method visibility and event support do not establish eligibility.
Integration and versionInstalled checkout product, gateway or extension, version and responsible maintainer.Apply Checkout Session event names only to that documented integration model.
Initial checkout eventFor hosted Stripe Checkout, the checkout.session.completed handler and its payment-status check.Completion may precede the payment outcome; unpaid must not trigger fulfillment.
Later success eventFor hosted Stripe Checkout, checkout.session.async_payment_succeeded subscription, handler and order mapping.Trace the later success to the intended saved order change and fulfillment decision.
Later failure eventFor hosted Stripe Checkout, checkout.session.async_payment_failed subscription, handler and order mapping.Record the failure and named next-action owner without inferring another payment is authorized.
Destination account scopeThe store’s actual destination selection and account connection.A subscription elsewhere is not evidence that this store receives the outcome.
Observed order resultAn existing real event, delivery record, handler result and matching order state where available.A 2xx response is delivery acknowledgment; no real record means observed behavior is unverified.
Duplicate and ordering handlingMaintainer’s explanation of how repeated or older events affect the same order.The documented delivery model allows both; completion should not depend on assumed delivery order.
Store action ownerNamed owner for each unresolved outcome and the record that will resolve the gap.Do not treat checkout enablement as completed event coverage.

These are temporary notes. Leaving or reloading this page may clear them. Worksheet entries are not sent automatically. If you copy notes into the consultation message and submit the form, Prism receives them as part of your request.

Limits

  • The named events and unpaid-session rule describe hosted Stripe Checkout Sessions. Other integrations require their own documented mapping.
  • This is a coverage review, not payment-method eligibility, a settlement-time promise or authorization to change subscriptions, replay events or submit payments.
  • Keep API keys, signing secrets, authentication codes, private payment links and customer payloads out of the worksheet and public form.

Sources

  • Stripe Checkout fulfillment — checked 2026-09-21. Hosted Checkout fulfillment must check session payment status and cannot rely on the return page alone. Unpaid sessions are not fulfilled; delayed methods have later asynchronous success and failure outcomes.
  • Stripe event delivery and verification — checked 2026-09-29. Destinations select account scope and event types. A 2xx acknowledges delivery rather than downstream completion, and events can arrive repeatedly or out of generation order.
  • Prism solutions — checked 2026-09-21. Prism’s published support includes storefront review and processing preparation, with scope, fees and terms discussed before work. Provider eligibility remains a separate provider decision.

Get help with checkout

Is this happening on your own store?