Skip to content
ParaSta Docs

Hosted Checkout

Hosted Checkout is a ParaSta-hosted payment page. You create a Checkout Session via API, redirect the customer to session.url, and listen for the checkout.session.completed webhook.

When to use

Section titled “When to use”
  • Web checkout where you don’t want to handle payment UI yourself
  • You want PCI/PII isolation — ParaSta handles all customer-facing payment data
  • You want network/token selection delegated to the customer at checkout time

Required parameters

Section titled “Required parameters”
  • line_items (array, min 1) — what the customer is paying for
  • success_url — where to send them after payment confirms
  • cancel_url — where to send them if they back out
Section titled “Optional but recommended”
  • customer_email — pre-fills the receipt email
  • metadata — your internal order ID, etc. Returned on the webhook event.
  • settlement — coin / krw / splits. Defaults to your account’s preference.

URL placeholders

Section titled “URL placeholders”

In success_url, {CHECKOUT_SESSION_ID} is substituted with the session ID:

https://your-site.com/success?session_id={CHECKOUT_SESSION_ID}

becomes

https://your-site.com/success?session_id=cs_abc123

Session lifecycle

Section titled “Session lifecycle”
  1. Create — status: open, customer hasn’t visited yet.
  2. Visited — customer opens the URL, picks network/token.
  3. Awaiting payment — customer sent funds; mempool detected.
  4. Complete — fully confirmed. payment.succeeded and checkout.session.completed events fire.

Sessions auto-expire after 1 hour by default. Expired sessions emit checkout.session.expired.

See also

Section titled “See also”