OPUSPAYCréer un compte
API • SDK • WEBHOOKS

Une API de paiement conçue pour les développeurs.

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.

0,10 € fixe par transaction

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.

Webhooks signés

Chaque événement inclut un identifiant et une signature vérifiable. Votre handler doit être idempotent pour accepter les nouvelles tentatives sans doublon.

Checkout universel

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.

COMMENT ÇA MARCHE

Une intégration backend en trois mouvements

  1. 01

    Générez vos clés marchandes

    Créez une clé publique et une clé secrète depuis le dashboard. Stockez la clé secrète uniquement dans les variables serveur.

  2. 02

    Créez la session de paiement

    Appelez POST /api/v1/checkout/create-session avec le montant, la devise, l’identifiant marchand et les URLs autorisées.

  3. 03

    Vérifiez le webhook

    Contrôlez la signature, le timestamp, l’identifiant d’événement et le montant enregistré avant de confirmer votre commande.

Créer une session avec l’API HTTP.

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"
}
QUESTIONS FRÉQUENTES

Ce qu’il faut savoir

Le SDK @opus-pay/sdk est-il déjà publié sur npm ?+

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.

Puis-je créer une session depuis le navigateur ?+

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.

Comment éviter de confirmer deux fois une commande ?+

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.

OPUS PAY

Une nouvelle façon d’accepter les paiements en euros.

Open Banking, SEPA Instant et outils d’intégration pensés pour les marchands.

Créer mon espace marchand