Creem.io Checkouts

Checkout Options

Programmatic Sessions - Full API control
Checkout Links - No-code, shareable URLs
Storefronts - Hosted product pages

Create Checkout Session

const session = await creem.checkout.sessions.create({
  product_id: 'prod_xxx',
  success_url: 'https://example.com/success?session_id={CHECKOUT_SESSION_ID}',
  cancel_url: 'https://example.com/cancel',

  // Optional parameters
  customer_email: 'user@example.com',
  customer_id: 'cus_xxx',           // Existing customer
  quantity: 1,                       // For seat-based products
  discount_code: 'LAUNCH20',         // Pre-apply discount
  metadata: {
    order_id: '123',
    referral_code: 'abc'
  },

  // Custom fields
  custom_fields: [
    { key: 'company', label: 'Company Name', required: true }
  ]
});

// Redirect user to checkout
redirect(session.url);

Checkout Customization

Configure in dashboard or via API:

Branding: Logo, colors, themes
Email Receipts: Custom templates
Localization: Auto-detect or force language (42 supported)
Custom Fields: Collect additional data

Retrieve Session

// GET /v1/checkout/sessions/:id
const session = await creem.checkout.sessions.retrieve('cs_xxx');
// Returns: { id, status, customer_id, product_id, amount, metadata, ... }

Success URL Parameters

Creem replaces {CHECKOUT_SESSION_ID} in success URL:

// Frontend: parse session ID from URL
const urlParams = new URLSearchParams(window.location.search);
const sessionId = urlParams.get('session_id');

// Backend: verify and fulfill
const session = await creem.checkout.sessions.retrieve(sessionId);
if (session.status === 'complete') {
  await fulfillOrder(session);
}

No-Code Checkout Links

Create in dashboard - shareable URLs for any product. Good for:

Social media links
Email campaigns
Quick sales without integration

Storefronts

Hosted product pages - display multiple products without custom website:

Configure storefront in dashboard
Add products to display
Share storefront URL
Customers browse and checkout

Cart Abandonment Recovery

Enable in dashboard - automatic emails sent when checkout abandoned:

Configurable delay before sending
Customizable email content
Include discount code incentive

Embedding (Coming)

For embedded checkout in your site, see SDK adapters:

Next.js Adapter
React components

See references/creem/sdk.md for implementation details.

2.5 KiB Raw Blame History