{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-platform/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Checkout events (checkout.stage_changed, checkout.closed)","siteUrl":"https://docs.glomo.one","llmstxt":{"title":"Glomo developer documentation","description":"Cross-border payments APIs, organised by product. Each product section carries both the explanation of its objects and the job-shaped integration guides that set them up.","details":{"content":"How to use these docs:\n\n- Get started is the front door. It has one section per integration\n  (what you're building), each with the API calls in order and the guide that builds it, plus\n  how to get API keys.\n- The product sections - Payin, Payout, Multi-currency accounts,\n  Verification, Request for Information (RFI) - each hold two kinds of page.\n  Pages titled as a noun (\"Subscriptions\", \"Bank Transfer\") explain what\n  an object is. Pages titled as a job (\"Set up recurring subscriptions\",\n  \"Collect LRS remittances from India\") are complete integration flows\n  and live one level under the object they set up. Match a user's goal\n  against the job-shaped titles first.\n- Reports and Identity and Access Management are the two subjects with no\n  API counterpart. There are no endpoints for reports, users, roles or\n  invites; both pages document the merchant dashboard. A dashboard\n  procedure for something the API also does (a refund, a payout) is NOT\n  here - it stays in the product that owns it.\n- API reference is generated from OpenAPI and carries endpoint detail.\n- The OpenAPI description itself is published as a single self-contained\n  document at /openapi.yaml, and the same document as JSON at\n  /openapi.json. Every $ref is resolved into it, so one fetch is the\n  whole contract: 61 paths, 81 operations, 68 schemas - the same\n  endpoints the API reference pages render. Fetch that instead of\n  reading the 129 pages under /api-reference/.\n- Every page below, in full, is one document at /llms-full.txt. Fetch that\n  instead of the pages one by one. It leaves out the API reference;\n  /openapi.yaml is that.\n- Developer resources covers what every integration touches and no single\n  product owns: auth, errors, pagination, rate limits, webhooks,\n  versioning, supported countries, quotes, the MCP server for AI\n  agents, and the client SDKs.\n"},"sections":[{"title":"Get started","description":"The front door. The ordered API calls for each integration and the guide that delivers it, how to obtain API keys, and the platform glossary.","includeFiles":["**/get-started/**"]},{"title":"Payin","description":"Collecting money: customers, orders, checkout, payment links, payment methods (cards, bank transfer, pay via bank), refunds, disputes, purpose codes, fee models, custom fields, subscriptions, and resident India remittance under LRS. Includes the flows that set each up - bank transfers, subscriptions, LRS remittances, and server-to-server card payments.","includeFiles":["**/payin/**"]},{"title":"Payout","description":"Sending money: the payout life cycle, queued payouts, creating and cancelling a payout, rails, beneficiaries, purpose codes, and the action required state. Includes the flow that sends a payout over the API.","includeFiles":["**/payout/**"]},{"title":"Multi-currency accounts","description":"Holding money: balances, balance conversion, adding balance, and withdrawing balance.","includeFiles":["**/multi-currency-account/**"]},{"title":"Verification","description":"Proving who someone is and that an account is theirs: KYC, bank account validation, and third-party verification (TPV) with the flow that verifies a payer's bank account.","includeFiles":["**/verification/**"]},{"title":"Request for Information (RFI)","description":"Responding to a compliance request for information, per object - payment link, order, payment, payout - plus compliance reviews and RFIs raised on already-successful payments.","includeFiles":["**/request-for-information/**"]},{"title":"Nivo (Capital markets)","description":"Nivo, Glomo's capital markets suite (Nivo for AMCs, Nivo for Distributors, and overseas investing for brokers and wealth platforms). Mutual fund investments run as payment sessions: the fund, distributor, scheme, plan, ARN and folio roles; the distributor's relationship with a fund and what it fixes; and the flow that opens a session as a distributor.","includeFiles":["**/capital-markets/**"]},{"title":"Reports","description":"The downloadable and scheduled reports a merchant pulls from the dashboard for reconciliation, compliance and treasury: payment, subscription, settlement breakup, balance statement and KYC reports, plus scheduling one for recurring email delivery and customizing the fields and column order of a report. Dashboard only - there is no reports API.","includeFiles":["**/reports/**"],"excludeFiles":["**/payin/**"]},{"title":"Identity and Access Management","description":"Administering who can use a merchant account: one set of credentials across multiple MIDs, switching between them without logging out, the Admin / Member / Sales Partner roles and what each may see and do, and inviting a new member. Dashboard only - there is no users, roles or invites API.","includeFiles":["**/access-management/**"]},{"title":"Settlement holidays","description":"The settlement holiday calendar for 2026 - the Indian and US bank and FX holidays on which payin, payout and settlement to the merchant's bank account may be delayed.","includeFiles":["**/settlement-holidays/**"]},{"title":"API reference","description":"Endpoint reference generated from the Glomo OpenAPI description.","includeFiles":["**/api-reference/**"]},{"title":"Developer resources","description":"What every integration touches and no single product owns: auth, errors, pagination, rate limits, webhooks, versioning, API validations, security, supported countries, quotes, connecting an AI agent to the Glomo MCP server, and the client SDKs - React Native, Flutter, Android and the Unified Web SDK, with per-version references and changelogs. Reports and Identity and Access Management used to be listed here and are now their own sections.","includeFiles":["**/platform/**"]}]},"description":"Reference for the Glomo checkout events contract v1: checkout.stage_changed and checkout.closed. Fields, types, possible values, stages, close reasons, delivery guarantees and versioning.","keywords":"checkout events, checkout.stage_changed, checkout.closed, payment stages, drop-off, Unified SDK"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"checkout-events","__idx":0},"children":["Checkout events"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Checkout events tell your page where a customer is in checkout while it is open, and why it closed. There are two: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]},". They are sent to the listeners you register with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".on()"]}," on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/platform/sdk/unified-sdk"},"children":["Unified SDK"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Client events are best effort. For the authoritative state of a payment, use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/platform/webhooks/payment"},"children":["payment webhooks"]},". For how far the customer got, use the payment's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/platform/webhooks/payment#payment-progress"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["progress"]}]}," field."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"availability","__idx":1},"children":["Availability"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Checkout"},"children":["Checkout"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"checkout.stage_changed"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"checkout.closed payload"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]}," payload"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LRS order opened with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]}," on the Unified SDK"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sent"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["v1 payload (this page)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LRS order opened with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/platform/sdk/legacy-web-sdk#legacy-lrs-sdk"},"children":["legacy LRS SDK"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LrsCheckoutApi"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sent"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["v1 payload (this page)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LRS payment session (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentSessionId"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not sent"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Standard checkout (orders, subscriptions)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not sent"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flutter, React Native, Android and iOS SDKs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not exposed yet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not exposed yet"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The events are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["enabled per merchant"]}," and are off by default. To turn them on, contact your Glomo account manager. The same switch also adds ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/platform/webhooks/payment#payment-progress"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["progress"]}]}," to the payment webhook and API, so you do not need to ask twice."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To check whether the events are on for your account, look at the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]}," payload. It contains ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v: 1"]}," when they are on, and is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]}," when they are off. It is also ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]}," when checkout fails before it finishes loading, so a single ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]}," does not prove the events are off."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-start","__idx":2},"children":["Quick start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Register listeners before you call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open()"]},". A listener registered later misses the events that were already sent."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const checkout = new GlomoCheckoutApi({\n  publicKey: 'live_XXXX',\n  orderId: 'order_XXXX',\n});\n\ncheckout.on('checkout.stage_changed', function (event) {\n  // event.stage is one of the payment stages below; event.step narrows it down\n  analytics.track('checkout_stage', {\n    orderId: event.resource.id,\n    journeyId: event.journeyId,\n    stage: event.stage,\n    step: event.step,\n  });\n});\n\ncheckout.on('checkout.closed', function (event) {\n  if (event.v !== 1) return; // events off for this account, or checkout failed before loading: the payload is {}\n  if (event.reason === 'completed') return; // the payment journey finished; wait for the webhook\n  analytics.track('checkout_abandoned', {\n    lastStage: event.lastStage,\n    reason: event.reason,\n  });\n});\n\nawait checkout.open();\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"checkoutstage_changed","__idx":3},"children":["checkout.stage_changed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sent when the customer reaches a new ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#payment-stages"},"children":["payment stage"]},", or a new step within the current stage."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sent at most once for each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]}," pair in one checkout open."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]}," never goes backwards within one checkout open. A stage reached after a later stage is not sent, so stages can be skipped."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retries are not reported. For example, a second OTP attempt sends nothing."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fields","__idx":4},"children":["Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Values"},"children":["Values"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payload version. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#versioning-and-compatibility"},"children":["Versioning and compatibility"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kyc"]}," is reserved."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["What the checkout is for. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]}," is a stage of this flow. Only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," is sent today."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Known: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lrs"]},". New values can be added."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment method."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resource.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kyc"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["session"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The kind of object the checkout was opened for. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]}," for an LRS order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resource.id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_XXXX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID of that object."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payt_XXXX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment attempt. Present from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attempt_created"]}," stage onward."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journeyId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Opaque"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies one checkout open. Every event from the same open carries the same value. A new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["open()"]}," gets a new value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Known values in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#payment-stages"},"children":["Payment stages"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The stage the customer reached. New stages can be added."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Known values in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#steps"},"children":["Steps"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The screen within the stage. Absent when the stage has no steps. New steps can be added."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provider"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Known (LRS): ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HDFC"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IDFC"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ICICI"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AXIS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KOTAK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The provider the customer chose. For LRS, the bank. Present from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_selected"]}," onward. Absent for a provider not in the known list. New values can be added."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journeyType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirect"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["native"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirect"]},": the customer approves on the provider's page. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["native"]},": the whole authentication happens inside checkout. Present from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_selected"]}," onward."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Open string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage: failed"]},", and not always present there. A Glomo payment error code or a checkout error code, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BANK_DECLINED"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segment.index"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 or more"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reserved. Not sent today. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#reserved"},"children":["Reserved"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segment.total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 or more, at least ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segment.index"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reserved. Not sent today."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 date-time, UTC, milliseconds"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When checkout sent the event, from the customer's device clock. Do not use it to order events across devices."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are the checkout error codes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}," can carry:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"errorCode"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT_INITIATION_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checkout could not create the payment or start it with the bank."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BANK_REDIRECT_UNAVAILABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checkout had no bank page to send the customer to."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BANK_CONNECTION_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checkout could not reach the bank, or could not open the bank's page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DOCUMENT_UPLOAD_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer's document could not be uploaded."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any other value is the error code of the payment or of the bank step that failed. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payin/payment#error-codes"},"children":["Error Codes"]},". New values can be added."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"examples","__idx":5},"children":["Examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["First event of a checkout open where the consent screen is shown:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"v\": 1,\n  \"flow\": \"payment\",\n  \"method\": \"lrs\",\n  \"resource\": { \"type\": \"order\", \"id\": \"order_6f1c2a9b7XyZ1\" },\n  \"journeyId\": \"a3f1c9e2-5b7d-4e8a-9c21-0f6b2d4e8a17\",\n  \"stage\": \"opened\",\n  \"step\": \"consent\",\n  \"at\": \"2026-11-16T09:30:12.418Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The customer is on the OTP screen after a payment attempt was created:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"v\": 1,\n  \"flow\": \"payment\",\n  \"method\": \"lrs\",\n  \"resource\": { \"type\": \"order\", \"id\": \"order_6f1c2a9b7XyZ1\" },\n  \"paymentId\": \"payt_6f1c2b04QmR8s\",\n  \"journeyId\": \"a3f1c9e2-5b7d-4e8a-9c21-0f6b2d4e8a17\",\n  \"stage\": \"customer_auth\",\n  \"step\": \"otp\",\n  \"provider\": \"HDFC\",\n  \"journeyType\": \"native\",\n  \"at\": \"2026-11-16T09:31:40.077Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payment failed:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"v\": 1,\n  \"flow\": \"payment\",\n  \"method\": \"lrs\",\n  \"resource\": { \"type\": \"order\", \"id\": \"order_6f1c2a9b7XyZ1\" },\n  \"paymentId\": \"payt_6f1c2b04QmR8s\",\n  \"journeyId\": \"a3f1c9e2-5b7d-4e8a-9c21-0f6b2d4e8a17\",\n  \"stage\": \"failed\",\n  \"provider\": \"HDFC\",\n  \"journeyType\": \"native\",\n  \"errorCode\": \"BANK_DECLINED\",\n  \"at\": \"2026-11-16T09:33:02.511Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"checkoutclosed","__idx":6},"children":["checkout.closed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sent once when checkout closes itself: when the customer closes it, when the customer cancels, after an error, and after the payment journey finishes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," sent when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["your code calls ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["close()"]},";"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the customer closes the SDK's own loading or configuration-error screen;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}," redirect takes the customer away from your page;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the customer closes the browser tab."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"closed-event-fields","__idx":7},"children":["Closed event fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Values"},"children":["Values"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payload version."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kyc"]}," is reserved."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["As on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Known: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lrs"]},". New values can be added."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["As on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resource.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kyc"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["session"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["As on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resource.id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_XXXX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["As on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payt_XXXX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Present when a payment attempt was created before checkout closed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journeyId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Opaque"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Same value as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]}," events from this checkout open."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastStage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Known values in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#payment-stages"},"children":["Payment stages"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The last stage sent in this checkout open. Absent if none was sent."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastStep"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Known values in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#steps"},"children":["Steps"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The step sent with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastStage"]},", when there was one."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reason"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Known values in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#close-reasons"},"children":["Close reasons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Why checkout closed. New reasons can be added."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 date-time, UTC, milliseconds"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When checkout closed, from the customer's device clock."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"close-reasons","__idx":8},"children":["Close reasons"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are all the close reasons sent today. New reasons can be added within v1, so do not fail on a reason you do not recognise."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"reason"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reason"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When it is sent"},"children":["When it is sent"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer closed checkout after the payment journey finished. Wait for the payment webhook for the outcome."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer chose to leave and confirmed it, for example in the exit prompt or by declining consent. Closing does not cancel a payment attempt that was already created: read the payment ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_dismissed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer closed checkout from a screen that closes without a confirmation prompt, for example while waiting for the bank."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checkout closed from its error screen, or after an error it could not recover from."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmation_timeout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checkout stopped waiting for the provider to confirm the payment. The payment can still complete. Wait for the payment webhook."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"closed-event-example","__idx":9},"children":["Closed event example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"v\": 1,\n  \"flow\": \"payment\",\n  \"method\": \"lrs\",\n  \"resource\": { \"type\": \"order\", \"id\": \"order_6f1c2a9b7XyZ1\" },\n  \"paymentId\": \"payt_6f1c2b04QmR8s\",\n  \"journeyId\": \"a3f1c9e2-5b7d-4e8a-9c21-0f6b2d4e8a17\",\n  \"lastStage\": \"customer_auth\",\n  \"lastStep\": \"otp\",\n  \"reason\": \"user_cancelled\",\n  \"at\": \"2026-11-16T09:32:15.902Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payload-when-the-events-are-not-enabled","__idx":10},"children":["Payload when the events are not enabled"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Until checkout events are enabled for your account, and for the checkouts marked ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]}," in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#availability"},"children":["Availability"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]}," is still sent and your listener receives an empty object, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{}"]},". Write your listener so that it works with both shapes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-stages","__idx":11},"children":["Payment stages"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stages of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow: payment"]},", in the order a customer reaches them:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"opened -> method_selected -> details_submitted -> attempt_created -> customer_auth\n       -> provider_handoff -> awaiting_confirmation -> confirmed\n                                                    \\-> failed  (can follow any stage)\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are all the stages sent today. New stages can be added within v1, so ignore a stage you do not recognise. Not every customer passes through every stage."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Order"},"children":["Order"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"stage"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Steps"},"children":["Steps"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opened"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checkout is showing its first screen."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_list"]},", or none"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_selected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer chose how to pay. For LRS, the bank. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provider"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journeyType"]}," are set from here on."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details_submitted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer submitted their details and moved on to pay."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attempt_created"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Glomo created a payment attempt. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentId"]}," is set from here on."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_auth"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer is authenticating inside checkout."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["otp"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["document_upload"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["txn_summary"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agreements"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provider_handoff"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer was sent to the provider's page to approve the payment. Sent only for journeys with a provider page."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["7"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting_confirmation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Checkout is waiting for the provider to confirm the payment."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["8"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The provider confirmed the payment. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.success"]}," follows."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["none"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["9"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment failed. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]}," may say why. Not sent when the customer cancels or when confirmation times out. Those appear only as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]}," reason."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["none"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"steps","__idx":12},"children":["Steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are all the steps sent today. New steps can be added within v1, so ignore a step you do not recognise."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"stage"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"step"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Screen"},"children":["Screen"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opened"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer is asked for consent."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opened"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer is choosing a bank."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_auth"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["otp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One-time password from the bank."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_auth"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["document_upload"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer uploads a document the bank asks for."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_auth"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["txn_summary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer reviews the transaction summary."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_auth"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agreements"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer accepts the bank's terms."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-and-ordering","__idx":13},"children":["Delivery and ordering"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Best effort."]}," Events travel from the checkout frame to your page in the browser. They are not retried or replayed, and they stop when the customer closes the tab or leaves the page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Once."]}," Each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]}," pair is sent at most once per ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journeyId"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]}," is sent at most once per ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journeyId"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["In order, within one event name."]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]}," events for one ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journeyId"]}," arrive in stage order. Do not rely on ordering between different event names, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.failure"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deduplicate"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["journeyId"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]}," if you forward events to your server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Isolated listeners."]}," An exception thrown in one listener does not stop the others."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]},"."]}," With a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]}," still reach your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".on()"]}," listeners. The redirect on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.success"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.failure"]}," usually leaves your page before ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]}," is sent."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authoritative state"]}," comes from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/platform/webhooks/payment"},"children":["payment webhooks"]},", never from client events."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"versioning-and-compatibility","__idx":14},"children":["Versioning and compatibility"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v"]}," is the payload version. It is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}," for every payload described here."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Within v1, changes are additive only: new optional fields, new stages, new steps, new close reasons, and new values for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provider"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errorCode"]},". The tables on this page list every value sent today."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A change that removes or renames a field, or changes the meaning of a value, ships as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v: 2"]}," alongside v1. It does not replace v1 in place."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your code must ignore fields and values it does not recognise. It must not fail on them."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"json-schema","__idx":15},"children":["JSON Schema"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The JSON Schema (draft-07) for the v1 payloads is at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.glomo.one/schemas/checkout-events/v1.json"},"children":["https://docs.glomo.one/schemas/checkout-events/v1.json"]},". It has one definition per event: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CheckoutStageChanged"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CheckoutClosed"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stage"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastStage"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reason"]}," are open strings in the schema, so values added within v1 still validate. Each field's description lists the values known today."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"relation-to-payment-outcomes-and-webhooks","__idx":16},"children":["Relation to payment outcomes and webhooks"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Signal"},"children":["Signal"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Where"},"children":["Where"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Signed"},"children":["Signed"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use it for"},"children":["Use it for"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.success"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.failure"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Browser, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".on()"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.success"]}," is"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Showing the result to the customer. Verify the signature on your server."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.stage_changed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Browser, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".on()"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Live progress and drop-off analytics."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Browser, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".on()"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Knowing that checkout closed, where the customer was, and why."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment webhook, including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["progress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your server"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The authoritative status, and the last stage recorded by Glomo, even when the page never received client events."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Client events use camelCase. The server uses snake_case under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["progress"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Client ( checkout.closed )"},"children":["Client (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout.closed"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Server ( progress )"},"children":["Server (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["progress"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastStage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["progress.last_stage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastStep"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["progress.last_step"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["progress.at"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The stage values are the same strings. The server records a subset of the stages. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/platform/webhooks/payment#payment-progress"},"children":["Payment progress"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reserved","__idx":17},"children":["Reserved"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are defined in v1 but not sent today. Do not build on them yet."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow: kyc"]}," with stages ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opened"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_progress"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submitted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["under_review"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["action_required"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rejected"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segment"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["index"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]},"), for checkouts that run several parts in one session."]}]}]},"headings":[{"value":"Checkout events","id":"checkout-events","depth":1},{"value":"Availability","id":"availability","depth":2},{"value":"Quick start","id":"quick-start","depth":2},{"value":"checkout.stage_changed","id":"checkoutstage_changed","depth":2},{"value":"Fields","id":"fields","depth":3},{"value":"Examples","id":"examples","depth":3},{"value":"checkout.closed","id":"checkoutclosed","depth":2},{"value":"Closed event fields","id":"closed-event-fields","depth":3},{"value":"Close reasons","id":"close-reasons","depth":3},{"value":"Closed event example","id":"closed-event-example","depth":3},{"value":"Payload when the events are not enabled","id":"payload-when-the-events-are-not-enabled","depth":3},{"value":"Payment stages","id":"payment-stages","depth":2},{"value":"Steps","id":"steps","depth":3},{"value":"Delivery and ordering","id":"delivery-and-ordering","depth":2},{"value":"Versioning and compatibility","id":"versioning-and-compatibility","depth":2},{"value":"JSON Schema","id":"json-schema","depth":2},{"value":"Relation to payment outcomes and webhooks","id":"relation-to-payment-outcomes-and-webhooks","depth":2},{"value":"Reserved","id":"reserved","depth":2}],"frontmatter":{"seo":{"title":"Checkout events (checkout.stage_changed, checkout.closed)","description":"Reference for the Glomo checkout events contract v1: checkout.stage_changed and checkout.closed. Fields, types, possible values, stages, close reasons, delivery guarantees and versioning.","keywords":"checkout events, checkout.stage_changed, checkout.closed, payment stages, drop-off, Unified SDK"}},"lastModified":"2026-11-17T11:51:20.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/platform/sdk/checkout-events","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}