Passer au contenu principal
La façon la plus rapide d’intégrer. Créez une session de checkout, redirigez le client vers son URL, et laissez Orqex gérer le choix de méthode, les actions suivantes et la confirmation.

​
Créer une session de checkout

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": "Commande #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" }
  }'

​
Corps de la requête

​
amount
number
requis
Montant en unités majeures (ex. 50). Minimum 1.
​
currency
string
requis
Code ISO 4217 à trois lettres, majuscule.
​
description
string
requis
Affichée au client sur la page.
​
customer
object
requis
Client (email, first_name, last_name).
​
return_url
string
Où le client est redirigé après le checkout.
​
webhook_url
string
Où Orqex envoie les événements de ce paiement.
​
customization
object
Thème de la page.

​
Ensuite

  1. Redirigez le client vers checkout.url.
  2. Il paie sur la page hébergée.
  3. Il revient sur votre return_url (signal UX uniquement).
  4. Vérifiez le paiement ou réagissez au webhook.
Besoin de contrôler toute l’UI ? Faites une intégration custom.