Passer au contenu principal
Initier un paiement se fait en deux étapes : créer une intention de paiement, puis lancer une tentative avec une méthode et un pays. Vous pouvez aussi faire les deux en un seul appel.

​
1. Créer une intention de paiement

curl https://api.orqex.com/v1/payment/intents \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: commande-1024" \
  -d '{
    "amount": 50,
    "currency": "XOF",
    "description": "Commande #1024",
    "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 à débiter, en unités majeures (ex. 50 pour 50 XOF). Minimum 1.
​
currency
string
requis
Code devise ISO 4217 à trois lettres, majuscule (ex. XOF).
​
description
string
requis
Brève description de ce que paie le client.
​
customer
object
requis
Le client débité.
​
webhook_url
string
URL où Orqex envoie les événements de ce paiement.
​
return_url
string
URL de retour du client après le paiement.
​
metadata
object
Jusqu’à 10 paires clé/valeur arbitraires, renvoyées telles quelles.
​
attempt
object
Optionnel : démarrer un paiement dans le même appel.

​
2. Lancer une tentative

Choisissez une méthode et un pays. Pour le mobile money, incluez le téléphone du payeur. 
curl https://api.orqex.com/v1/payment/intents/TRX123/attempt \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "method_code": "momo_mtn",
    "country": "CI",
    "phone": { "number": "0700000000", "country": "CI" }
  }'
Résolvez ensuite le next_action de la tentative (OTP, redirection, QR, validation) — voir Concepts clés. Une fois le client agi, vérifiez le paiement.
Pas envie de construire une UI de paiement ? Utilisez le checkout hébergé — Orqex gère le choix de méthode et les actions suivantes pour vous.