Enrôler un Mobile Wallet
Instruments de paiement
Enrôler un mobile wallet
Rattacher un instrument de paiement de type mobile wallet à un usager déjà enrôlé dans GIMpay.
POST
Enrôler un Mobile Wallet
Cet appel rattache un mobile wallet supplémentaire à un usager qui existe déjà dans GIMpay. Il ne crée pas d’usager : pour le premier instrument, utilisez plutôt l’enrôlement d’usager, qui crée l’usager et son instrument en un seul appel.
Avant d’appeler
1
L'usager doit exister
Vous avez besoin de sa
refUsager (la refUsagerGIMpay retournée à l’enrôlement).2
Vérifiez que le wallet n'est pas déjà enrôlé
POST /check-existence et validation de l’OTP.Champs
Les cinq champs sont tous obligatoires :Réponses
Le corps utile arrive dansbody, à l’intérieur de l’enveloppe commune { message, status, body, timestamp }, et contient notamment refInstrumentPaiement — la référence de l’instrument nouvellement créé, à conserver.
Un 404 indique qu’une entité renseignée est introuvable : le plus souvent refUsager ou l’une des deux références de contributeur.
Et ensuite ?
Consulter le solde
GET /wallets/{referenceWallet}/balanceExécuter une opération
Utilisez ce nouvel instrument comme initiateur.
Authorizations
Jeton émis par POST /api/v1/auth/token.
Body
application/json
Le code ISO de l'instrument de paiement à enrôler
Example:
"CIV"
Numéro mobile money (typo msisdn conforme au contrat).
La référence du contributeur demandeur qui demande l'enrôlement de l'instrument de paiement
La référence du contributeur émetteur de l'instrument de paiement à enrôler
La reference de l'usager