Skip to main content
L’espace Développeurs dans le tableau de bord permet à vos équipes techniques de connecter vos boutiques e-commerce (WooCommerce, Shopify, Prestashop), applications mobiles (Flutter, React Native) ou backends (Node.js, Laravel, Python, Go) à l’infrastructure BizConnectPay.

1. Créer une application API

  1. Rendez-vous dans Développeurs > Applications.
  2. Cliquez sur Créer une application.
  3. Renseignez :
    • Nom de l’application : Ex: MonSiteCommerce-Prod ou AppMobile-Test.
    • Environnement :
      • SANDBOX : Pour simuler des paiements et tester vos webhooks avec de faux numéros sans argent réel.
      • LIVE : Pour traiter des transactions réelles en production.
    • Permissions (Scopes) : Cochez uniquement les accès requis (ex: payments.read, payments.write, cards.read).
  4. Validez pour générer vos clés d’API.

2. Identifiants d’accès

Une fois l’application créée, vous obtenez :
  • Client ID (ex: BCP_app_849102948194) : Identifiant public de votre application.
  • Client Secret : Clé privée confidentielle utilisée pour signer vos requêtes d’obtention de jetons JWT.
Le Client Secret ne sera affiché qu’une seule fois lors de sa création. Copiez-le immédiatement et enregistrez-le dans votre gestionnaire de secrets ou vos variables d’environnement serveur (.env).

3. Configuration des webhooks

Après la création de l’application, ouvrez ses paramètres, ajoutez une souscription webhook, puis saisissez votre URL HTTPS et sélectionnez les événements. Pour recevoir les paiements, sélectionnez payment.completed et payment.failed. La souscription ne reçoit que les événements des opérations créées avec cette application. BizConnectPay envoie un POST signé à votre URL lorsque le paiement atteint un statut final. Le secret de signature est affiché une seule fois. Répondez avec un statut HTTP 2xx après avoir enregistré l’événement. Dédupliquez les tentatives à l’aide de l’identifiant d’événement. Consultez Webhooks pour les exemples de corps, les en-têtes, la vérification HMAC et les nouvelles tentatives.