> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizconnectpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Espace Développeurs & Clés API

> Générez vos identifiants d'API, configurez vos webhooks et supervisez vos intégrations depuis le dashboard.

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.

> [!WARNING]
>
> 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](https://docs.bizconnectpay.com/webhooks.md) pour les exemples de corps, les en-têtes, la vérification HMAC et les nouvelles tentatives.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.