Skip to main content
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 :
Ici msidn est le numéro sans indicatif, alors que dans l’objet wallet de l’enrôlement d’usager le champ msisdn attend le numéro complet, indicatif inclus.

Réponses

Le corps utile arrive dans body, à 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}/balance

Exécuter une opération

Utilisez ce nouvel instrument comme initiateur.

Authorizations

Authorization
string
header
required

Jeton émis par POST /api/v1/auth/token.

Body

application/json
codeIso
string
required

Le code ISO de l'instrument de paiement à enrôler

Example:

"CIV"

msisdn
string
required

Numéro mobile money (typo msisdn conforme au contrat).

refContributeurDemandeur
string
required

La référence du contributeur demandeur qui demande l'enrôlement de l'instrument de paiement

refContributeurEmetteur
string
required

La référence du contributeur émetteur de l'instrument de paiement à enrôler

refUsager
string
required

La reference de l'usager

Response

Mobile Wallet enrôlé.

Enveloppe standard de toutes les réponses (sauf auth).

message
string

Message technique décrivant le résultat de l'appel.

status
integer

Code de statut HTTP de la réponse.

timestamp
string<date-time>

Horodatage de la réponse.

body
object