Enrôler une carte bancaire
Rattacher une carte bancaire de type débit ou prépayée à un usager déjà enrôlé dans GIMpay.
Champs requis selon le type de carte
Quatre champs sont exigés dans tous les cas —refUsager, refContributeurDemandeur, refContributeurEmetteur et typeCarteBancaire. Les autres dépendent du type de carte :
codeClient, pan, cvv et dateExpiration comme facultatifs, car aucun n’est requis pour tous les types. La combinaison réellement attendue est celle du tableau ci-dessus.Format des données de carte
Points de vigilance
typeCarteBancaire accepte DEBIT ou PREPAYEE
typeCarteBancaire accepte DEBIT ou PREPAYEE
CREDIT apparaît dans le suivi d’implémentation du SDK Flutter mais ne figure ni dans la spécification technique v1.1, ni dans le schéma OpenAPI servant le playground ci-dessous. Écart non arbitré — ne vous appuyez pas dessus sans confirmation de GIM.Aucune valeur de réseau de carte n'est définie
Aucune valeur de réseau de carte n'est définie
typeCarteBancaire porte le mode de fonctionnement de la carte, pas son réseau d’acceptation.Réponses
Le corps utile arrive dansbody, à l’intérieur de l’enveloppe commune { message, status, body, timestamp }, et contient refInstrumentPaiement ainsi que le PAN sous forme masquée.
Et ensuite ?
Vérifier les droits de la carte
GET /wallets/{referenceWallet}/authorizationExécuter une opération
Authorizations
Jeton émis par POST /api/v1/auth/token.
Body
Champs conditionnels selon typeCarteBancaire : PREPAYEE → seul codeClient est requis (pan, cvv, dateExpiration interdits) ; DEBIT/CREDIT → pan, cvv et dateExpiration sont requis (codeClient interdit).
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
DEBIT, CREDIT, PREPAYEE Requis pour PREPAYEE.
13 à 19 chiffres. Requis pour DEBIT/CREDIT.
Requis pour DEBIT/CREDIT.
Requis pour DEBIT/CREDIT.
MM/yyyy