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

# Fonctionnement

## Comment fonctionne GIMpay ?

Votre application n'interagit jamais directement avec les usagers finaux de GIMpay : en tant que **Contributeur Tiers de Service Financier (CTSF)**, votre backend appelle les APIs GIMgar Sud pour le compte de vos propres utilisateurs. Voici le déroulé type d'une opération financière, du token d'accès jusqu'à la confirmation.

**1. Authentification**

Votre backend échange son `client_id` / `client_secret` contre un token Bearer (OAuth2 `client_credentials`), à inclure dans chaque appel suivant.

**2. Identification de l'instrument de paiement**

Vous récupérez les instruments de paiement de l'usager (compte bancaire, carte ou mobile wallet) et vérifiez que le solde de l'instrument sélectionné couvre le montant de l'opération.

**3. Découverte du service et calcul des frais**

Vous identifiez le service proposé par le contributeur via sa Mini Market Place (MMP), puis simulez les frais applicables au montant saisi.

**4. Sécurisation par OTP**

GIMpay envoie un code OTP au numéro de téléphone associé à l'instrument de paiement initiateur. L'usager saisit ce code pour autoriser le débit.

**5. Exécution de l'opération**

Vous exécutez l'opération avec le code OTP validé. GIMpay traite la transaction et retourne son statut (`SUCCES`, `ECHOUE`, `ENCOURS`...).

Ce parcours n'est qu'un exemple parmi les usages possibles de la plateforme — GIMgar Sud expose aussi des APIs pour l'enrôlement d'usagers, la gestion des consentements, les programmes de fidélité, les documents d'identité et les favoris (bénéficiaires et MMP).

> **[Suivre le guide détaillé](https://sandbox.it-centrex.com/guides/integration-guide.md)**
>
> Le déroulé complet avec les endpoints exacts, étape par étape.

> **[Tester dans le sandbox](https://sandbox.it-centrex.com/getting-started/testing.md)**
>
> Exécutez chacune de ces étapes directement depuis la documentation.


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