Enchaînez les APIs GIMgar Sud pour transférer de l’argent d’un usager vers un instrument de paiement d’un autre usager, via le service d’un contributeur.
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
POST {{baseUrl}}/api/v1/auth/token
Récupérez un token Bearer à utiliser dans toutes les requêtes suivantes. Voir Authentication.
2
Collectez les instruments de paiement de l'usager
GET {{baseUrl}}/api/v1/users/{referenceUsager}/wallets
Identifiez l’instrument de paiement de l’usager initiateur à débiter.
3
Vérifiez le solde disponible
GET {{baseUrl}}/api/v1/wallets/{referenceWallet}/balance
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
GET {{baseUrl}}/api/v2/contributors/{referenceContributor}/transparent-mmp
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
GET {{baseUrl}}/api/v1/mmps/{referenceMmp}/contributors/{referenceContributor}/services
Identifiez le service à utiliser pour l’opération.
6
Calculez les frais
GET {{baseUrl}}/api/v1/services/{referenceService}/fees?amount={montant}
Simulez les frais applicables au montant saisi avant d’engager l’opération.
7
Générez un code OTP
POST {{baseUrl}}/api/v1/otp/debit
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
POST {{baseUrl}}/api/v1/operations
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.
