Stripe
Overview
When Stripe checkout opens from Eos in a separate window, the return page titled "Returning To Eos…" hands the result back to the Eos window that launched checkout and then closes itself. It shows one of three messages: a successful payment, a canceled checkout, or a generic return message when the status is not recognized.
The page reads the return URL for a status and an intent ID, sends that payload to the original Eos window, and then attempts to close automatically (it closes very quickly when allowed). If the browser blocks automatic closing, close the window manually and continue in Eos.
When you'll see this
- When Stripe Checkout opens in a separate window while you are paying for or updating a subscription.
- After you finish checkout (payment success) or cancel checkout.
- When you need to confirm whether the checkout completed before continuing in Eos.
- If support asks what message you saw after returning from checkout.
How it works
- The return page reads URL parameters:
- status — normalized to lowercase (common values: "success" or "cancel"; otherwise treated as unknown)
- intentId — an identifier tied to the checkout result (may be null)
- The page builds a payload:
- ok: true when status === "success", otherwise false
- status: the status value or "unknown"
- intentId: value or null
- The page sends the payload to the window that opened checkout using postMessage with source "eos-billing-checkout-callback".
- The page updates its on-screen message:
- "Payment completed. Returning you to your subscription overview." for success
- "Payment canceled. Returning you to the Manage plan window." for cancel
- A generic "Returning you to Eos." message for unknown status
- The page then attempts to close automatically (it waits a short time, then calls window.close()).
What the messages mean
- "Payment completed. Returning you to your subscription overview."
- Checkout finished successfully. Check Subscription overview in Eos for updated billing or plan status.
- "Payment canceled. Returning you to the Manage plan window."
- You canceled checkout. No payment was completed in this step. Use Manage plan to review options or try again.
- Generic "Returning you to Eos."
- The return page did not receive a recognized status. Confirm billing or subscription status in Eos before assuming the payment succeeded.
Typical workflow (what to do)
- Start a billing action in Eos that opens Stripe Checkout in a separate window (for example, updating a plan or completing a payment).
- Complete or cancel checkout in the Stripe window.
- Note the message shown in the "Returning To Eos…" window:
- If it shows the completed message, switch back to Eos and check Subscription overview.
- If it shows the canceled message, continue in Manage plan if you still need to choose or buy a plan.
- If it shows the generic message, return to Eos and verify billing or subscription state.
- Wait a moment for the return window to close automatically.
- If the return window remains open, close it manually and continue in the main Eos window.
- If you closed the original Eos window before checkout finished, reopen Eos and check Subscription overview or Manage plan to confirm the payment or subscription state.
Technical details useful for support
- postMessage source: "eos-billing-checkout-callback"
- Payload shape: { ok: boolean, status: string, intentId: string | null }
- Common status values: "success", "cancel", or other/unknown
- The page attempts to close automatically after a short delay; browsers that block script-initiated close may require a manual close.
Fields and labels you will see
- Title: "Returning To Eos…"
- Success message: "Payment completed. Returning you to your subscription overview."
- Cancel message: "Payment canceled. Returning you to the Manage plan window."
- Generic message: "Returning you to Eos."
- Auto-close behavior: The window tries to close itself after posting the result.
Things to watch for
- If you see "Payment canceled", no payment completed. Reopen checkout from Manage plan to try again.
- If the return window does not close automatically, close it manually and continue in Eos.
- If you get the generic message, verify billing in Subscription overview before relying on the payment.
- If the original Eos window was closed before checkout finished, Eos will not receive the postMessage; reopen Eos and check subscription/payment status.
- The intent ID may not always be present. If you contact support about a payment, provide the return message you saw and any billing details visible in Eos.
Related areas
- Billing
- Subscriptions
- Manage plan
- Subscription overview
- Popup-based checkout flows