Skip to main content
The fastest way to integrate. Create a checkout session, redirect the customer to its URL, and let Orqex handle method selection, next actions and confirmation.

​
Create a checkout session

curl https://api.orqex.com/v1/payment/checkouts \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50,
    "currency": "XOF",
    "description": "Order #1024",
    "return_url": "https://shop.example.com/return",
    "webhook_url": "https://shop.example.com/webhooks/orqex",
    "customer": { "email": "[email protected]", "first_name": "Ama", "last_name": "Mensah" }
  }'

​
Request body

​
amount
number
required
Amount in major units (e.g. 50). Minimum 1.
​
currency
string
required
Three-letter ISO 4217 code, uppercase.
​
description
string
required
Shown to the customer on the page.
​
customer
object
required
Customer (email, first_name, last_name).
​
return_url
string
Where the customer is redirected after checkout.
​
webhook_url
string
Where Orqex POSTs this payment’s events.
​
customization
object
Theme the page.

​
Then

  1. Redirect the customer to checkout.url.
  2. They complete payment on the hosted page.
  3. They return to your return_url (a UX signal only).
  4. Verify the payment or react to the webhook.
Need full control of the UI? Build a custom integration instead.