Orangepill Cloud
Sign up

Build a checkout session

Problem

Teams need a secure, multi-rail checkout without building separate payment flows.

Architecture

Checkout session
Application
Checkout Session
Payment Options
Payment Attempt
Confirmation

Implementation

Implementation

  1. 1Create a checkout session with amount and currency.
  2. 2Render the hosted page or embed options.
  3. 3Confirm payment via webhook or return URL.
  4. 4Fulfill the order based on status.

API example

Create checkout session
const session = await orangepill.checkout.sessions.create({
  amount: 50000,
  currency: "COP"
})

Production considerations

  • Enable retries and routing rules for better conversion.
  • Validate webhook signatures.
  • Record payment attempts for reconciliation.
  • Localize payment methods per market.