API serveur
Les clés secrètes restent exclusivement sur votre backend. Les montants sont transmis en euros avec une référence marchande et des URLs de retour autorisées.
Créez une session côté serveur, envoyez le client vers le checkout Opus, puis confirmez la commande à partir d’un webhook signé. Le rail bancaire reste isolé de votre logique métier.
Les clés secrètes restent exclusivement sur votre backend. Les montants sont transmis en euros avec une référence marchande et des URLs de retour autorisées.
Chaque événement inclut un identifiant et une signature vérifiable. Votre handler doit être idempotent pour accepter les nouvelles tentatives sans doublon.
Le checkout hébergé fonctionne depuis un site Next.js, Node.js, un CMS ou un QR code généré au point de vente.
Créez une clé publique et une clé secrète depuis le dashboard. Stockez la clé secrète uniquement dans les variables serveur.
Appelez POST /api/v1/checkout/create-session avec le montant, la devise, l’identifiant marchand et les URLs autorisées.
Contrôlez la signature, le timestamp, l’identifiant d’événement et le montant enregistré avant de confirmer votre commande.
Exemple conceptuel côté serveur. Utilisez toujours la clé secrète dans une variable d’environnement et jamais dans un composant client.
POST https://www.opuspay.fr/api/v1/checkout/create-session
Authorization: Bearer $OPUS_SECRET_KEY
Content-Type: application/json
{
"amount": 240.00,
"currency": "EUR",
"merchant_id": "NX_LIVE_...",
"redirect_url": "https://boutique.fr/merci"
}Pas encore. Le code du SDK existe dans le projet, mais la publication officielle sur npm doit être réalisée avant de conseiller son installation en production. L’API HTTP reste la référence actuelle.
Non avec une clé secrète. La création doit passer par votre backend ou par le connecteur sans-code autorisé, afin de ne jamais exposer les secrets ni permettre la modification du montant.
Stockez l’identifiant unique de l’événement webhook et rendez votre traitement idempotent. Un événement déjà traité doit renvoyer un succès sans répéter l’expédition ou la comptabilisation.
Open Banking, SEPA Instant et outils d’intégration pensés pour les marchands.
Créer mon espace marchand