Vérifier l'existence d'un instrument de paiement
Vérification d'existence
Vérifier l'existence d'un instrument de paiement
Déterminer si un instrument de paiement est déjà enrôlé dans GIMpay, et déclencher l’envoi d’un OTP si ce n’est pas le cas.
POST
Vérifier l'existence d'un instrument de paiement
C’est le point de départ de tout enrôlement. Cet appel vérifie si un instrument de paiement est déjà connu de GIMpay et, s’il ne l’est pas, déclenche l’envoi d’un OTP au numéro rattaché au compte amorçant ainsi le parcours d’enrôlement.
Interpréter la réponse
La logique de cet endpoint est inversée par rapport à ce que son nom suggère :Les quatre champs sont obligatoires
Contrairement à beaucoup d’endpoints où certains champs sont facultatifs, les quatre sont ici tous exigés :Notez soigneusement
indicatif et numero : la vérification de l’OTP exigera exactement les mêmes valeurs.Réponses
Le corps utile est un booléen dansbody, à l’intérieur de l’enveloppe commune { message, status, body, timestamp }. Un 404 indique que le contributeur renseigné est introuvable — vérifiez refContributeurEmetteur via GET /contributors.
Voir la référence des codes d’erreur.
Et ensuite ?
Vérifier l'OTP
Validez le code reçu par l’usager auprès du contributeur émetteur.
Enrôler l'usager
Créez l’usager et rattachez son premier instrument de paiement.
Authorizations
Jeton émis par POST /api/v1/auth/token.
Body
application/json
La référence du contributeur émetteur de l'instrument de paiement à enrôler
MSISDN (mobile wallet), RIB (compte bancaire), code client (carte prépayée) ou 4 derniers chiffres du PAN (carte bancaire).
Numéro local du téléphone.
Indicatif international pays, sans le symbole +.
Example:
"225"