Projects

A Checkout Session's outcome, read from Stripe

Reads the session from Stripe on the connected account and returns its curated outcome: status (open, complete, expired), payment_status (paid, unpaid, no_payment_required), mode, customer_id, subscription_id, payment_intent_id, amount_total, currency, customer_email, client_reference_id, metadata (your keys only). Use it on the success page; a SEPA debit reads unpaid until it clears, then stripe_checkout_completed arrives. A session another project created is 403; an id unknown within this project's sessions is 404 STRIPE_CHECKOUT_SESSION_NOT_FOUND. Never lifecycle-gated.

get/projects/v1/{project_id}/stripe/checkout-sessions/{checkout_session_id}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/projects/v1/{project_id}/stripe/checkout-sessions/{checkout_session_id}
  • Auth: one of:
    • HTTP bearer
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer
    • HTTP bearer

Path parameters

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

Example:prj_1741340000_0042

The project through which the organization's Stripe account is reached. A service_key acts only for its OWN project; principals and grant keys authorize via project.stripe.manage (mutations) or project.read (reads). The account belongs to the project's owning organization, read fresh.

checkout_session_idstring required

The Stripe Checkout Session id this project created.

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Response

The outcome.

checkout_session_idstring required
statusstring nullable required

open, complete, expired.

payment_statusstring nullable required

paid, unpaid, no_payment_required.

modestring nullable
customer_idstring nullable
subscription_idstring nullable
payment_intent_idstring nullable
amount_totalinteger nullable

Minor units.

currencystring nullable
customer_emailstring nullable
client_reference_idstring nullable
metadataobject required

Your keys only; the run402_ stamps are stripped.

created_atstring date-time nullable
expires_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.