Passer au contenu principal
Il existe deux façons d’encaisser. Les deux reposent sur la même orchestration en dessous (routage, sélection de passerelle, basculement automatique) — elles diffèrent sur qui construit l’expérience de paiement.

Checkout hébergé

Redirigez vers une page hébergée par Orqex. Le plus rapide.

Custom (API directe)

Construisez votre UI et pilotez l’API. Contrôle total.

Comparaison

Checkout hébergéCustom (API directe)
Vous construisezUne redirection + une page de retourToute l’UI de paiement
Actions suivantes (OTP, redirection, QR, validation)Gérées par OrqexVous les affichez depuis next_action
Choix de la méthodeSur la page hébergéeDans votre UI
EffortFaiblePlus élevé
Contrôle de l’UXLimité au thèmeTotal
Idéal pourLancer viteCheckout sur-mesure, embarqué

Ce que les deux exigent

  • Une clé secrète côté serveur. Voir Authentification.
  • Un webhook pour connaître le statut final. Voir Webhooks.
  • Comptes passerelles et règles de routage dans le dashboard.

Comment choisir

1

Lancer vite ou pas d'UI à construire ?

Utilisez le checkout hébergé.
2

Expérience sur-mesure et embarquée ?

Initiez un paiement directement sur l’API.
3

Pas sûr ?

Démarrez en hébergé pour aller en prod, puis passez au custom — le modèle d’intention est le même, la migration est incrémentale.