Passer au contenu principal
Orqex propose deux environnements isolés. Celui qu’une requête atteint est déterminé par la clé API utilisée, pas par l’URL : l’URL de base est la même pour les deux.
EnvironnementUsageClés
SandboxConstruire et tester sans argent réel. Utilisez les identifiants de test des prestataires et des numéros de test.Clés secrètes sandbox.
LiveTransactions réelles avec de l’argent réel.Clés secrètes live.
https://api.orqex.com/v1

Isolation

Chaque environnement est totalement isolé. Les comptes passerelles, règles de routage, clients, intentions de paiement et clés API créés en sandbox n’apparaissent jamais en live, et inversement. Un paiement créé avec une clé sandbox ne peut être manipulé qu’avec une clé sandbox.
Gardez vos clés spécifiques à l’environnement dans la configuration (ex. valeurs .env séparées par environnement). Utiliser une clé live dans un chemin de test — ou l’inverse — est l’erreur d’intégration la plus courante.

Flux recommandé

1

Intégrer en sandbox

Configurez des comptes passerelles sandbox et construisez tout le flux avec des identifiants de test.
2

Tester les cas limites

Exercez les chemins succès, refus, action requise et timeout avant le passage en live.
3

Passer en live

Remplacez la clé secrète par celle de production. Aucun changement de code ni d’URL.

Avec le SDK PHP

Rien de particulier : passez la clé de l’environnement visé.
use Orqex\Orchestrate\OrchestrateClient;

$sandbox = new OrchestrateClient(config('services.orqex.sandbox_key'));
$live    = new OrchestrateClient(config('services.orqex.live_key'));