Use Case

Hosted Checkout

Build a branded payment page using checkout sessions with multi-rail options and unified confirmation.

Problem

Teams need a secure, high-conversion checkout without building multiple payment flows from scratch.

Architecture
Application
Checkout Session
Payment Options
Payment Attempt
Confirmation

Implementation

  1. 1Create a checkout session with amount and currency.
  2. 2Render the hosted page with localized payment options.
  3. 3Handle confirmation via webhook or return URL.
  4. 4Record the payment result and fulfill the order.
Create checkout session
const session = await orangepill.checkout.sessions.create({
  amount: 50000,
  currency: "COP"
})

Production considerations

  • Enable retries and smart routing for declined payments.
  • Use webhook signatures to validate confirmations.
  • Log payment attempts for reconciliation.
  • Localize payment methods per market.

Start building with Orangepill

Get access to programmable financial infrastructure and launch faster.