Skip to main content
Ce guide décrit un cas d’usage complet : un usager GIMpay transfère de l’argent vers l’instrument de paiement d’un autre usager, par le biais du service d’un contributeur. D’abord, vous authentifiez votre backend. Puis vous vérifiez les instruments de paiement de l’usager initiateur (carte, compte, mobile wallet) et son solde disponible. La plateforme récupère ensuite les services proposés par le contributeur, calcule les frais applicables, et envoie un code de sécurité (OTP) pour valider l’opération. Une fois ce code confirmé, l’opération est exécutée.
1

Authentifiez votre backend

Récupérez un token Bearer à utiliser dans toutes les requêtes suivantes. Voir Authentication.
2

Collectez les instruments de paiement de l'usager

Identifiez l’instrument de paiement de l’usager initiateur à débiter.
3

Vérifiez le solde disponible

Assurez-vous que le solde de l’instrument sélectionné couvre le montant de l’opération.
4

Collectez la mini-place de marché transparente du contributeur

Récupérez la Mini Market Place (MMP) transparente associée au contributeur à travers lequel l’opération transitera.
5

Collectez les services du contributeur dans cette MMP

Identifiez le service à utiliser pour l’opération.
6

Calculez les frais

Simulez les frais applicables au montant saisi avant d’engager l’opération.
7

Générez un code OTP

Envoyez un OTP au numéro de téléphone associé à l’instrument de paiement initiateur, pour sécuriser le débit.
8

Exécutez l'opération

Une fois l’OTP saisi par l’usager, transmettez-le dans le champ authData et exécutez l’opération.
Avant d’enrôler un usager ou d’exécuter une opération, vous pouvez vérifier les droits de l’usager, de l’instrument de paiement ou du terminal impliqué via les endpoints GET /users/{referenceUsager}/authorization, GET /wallets/{referenceWallet}/authorization et GET /terminals/{serialNumber}/authorization.

​
Étapes suivantes

Tester ce flux dans le sandbox

Exécutez chacune de ces étapes directement depuis la documentation.

Codes d'erreur

Comprenez les erreurs possibles à chaque étape.