Passer au contenu principal
Testez tout le flux de paiement en sandbox avant de passer en live. Aucun argent réel ne circule en sandbox.

​
Utiliser l’environnement sandbox

Authentifiez-vous avec une clé secrète sandbox. L’URL de base est la même qu’en live — l’environnement est déterminé par la clé. 
curl https://api.orqex.com/v1/payment/intents \
  -H "Authorization: Bearer sk_sandbox_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 50, "currency": "XOF", "description": "Commande test",
        "customer": { "email": "[email protected]", "first_name": "Test", "last_name": "User" } }'
Le sandbox est totalement isolé du live : comptes passerelles, paiements et clés ne se croisent jamais. Voir Environnements.

​
Test Payment Gateway

Chaque projet sandbox embarque une passerelle de test intégrée, reliée à une méthode de paiement test dédiée et routée automatiquement — aucun compte passerelle à configurer. Tentez un paiement sandbox avec method_code à test ; les deux derniers chiffres du numéro de téléphone du payeur déterminent le résultat.

​
Simuler des scénarios

Le résultat est déterminé par les deux derniers chiffres du numéro du payeur — donc n’importe quel numéro valide, de n’importe quel pays, fonctionne ; seule la fin compte :
  • se termine par 01 → en attente
  • se termine par 02 → échoué
  • toute autre fin → réussi
Les numéros US ci-dessous ne sont que des exemples pratiques ; tout numéro valide se terminant de la même façon déclenche le même scénario (ex. un numéro ivoirien +225…01 est aussi en attente, un +225…02 aussi échoué).
ScénarioExemple de numéroRésultat
Paiement réussi+1 415 555 0100Tentative et intention passent à completed.
Paiement en attente+1 415 555 0101La tentative reste processing ; elle passe à completed à la vérification / réconciliation.
Paiement échoué+1 415 555 0102La tentative passe à failed avec une raison.
curl https://api.orqex.com/v1/payment/intents \
  -H "Authorization: Bearer sk_sandbox_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000, "currency": "USD", "description": "Commande test",
    "customer": { "email": "[email protected]", "first_name": "Test", "last_name": "User" },
    "attempt": {
      "method_code": "test", "country": "US",
      "phone": { "number": "+14155550102", "country": "US" }
    }
  }'
La passerelle de test et sa méthode test n’existent qu’en sandbox — elles n’apparaissent jamais en live. Utilisez un numéro se terminant par 01 ou 02 pour exercer les cas en attente et échoué.

​
Tester avec le sandbox d’un prestataire

Pour tester avec un vrai prestataire, ajoutez un compte passerelle sandbox avec ses identifiants sandbox et routez vers lui. Les numéros, cartes et OTP de test propres au prestataire viennent de sa propre documentation sandbox.

​
Tester les webhooks

Pointez webhook_url vers une URL publiquement accessible (utilisez un tunnel comme ngrok en local). Orqex livre les mêmes événements en sandbox ; vérifiez votre handler en re-récupérant le paiement. Voir Webhooks.

​
Passer en live

Une fois vos flux validés en sandbox, remplacez la clé sandbox par une clé live — aucun changement de code ni d’URL.