Skip to main content
There are two ways to take a payment. Both run on the same orchestration underneath (routing, gateway selection and automatic failover) — they differ in who builds the payment experience.

Hosted checkout

Redirect to an Orqex-hosted page. Fastest to launch.

Custom (direct API)

Build your own UI and drive the API. Full control.

Comparison

Hosted checkoutCustom (direct API)
You buildA redirect + a return pageThe full payment UI
Next actions (OTP, redirect, QR, approval)Handled by OrqexYou render them from next_action
Method selectionOn the hosted pageIn your UI
EffortLowHigher
Control over UXLimited to themingTotal
Best forLaunch fastBespoke, embedded checkout

What both require

  • A server-side secret key. See Authentication.
  • A webhook to learn the final status. See Webhooks.
  • Gateway accounts and routing rules configured in the dashboard.

How to choose

1

Launch fast or no UI to build?

2

Bespoke, embedded experience?

Initiate a payment directly on the API.
3

Not sure?

Start hosted to go live, then move to custom — the payment intent model is the same, so the migration is incremental.