Mise à jour des Données Carte

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Faire un retour sur cette page

Introduction

Worldline Sips est une solution de paiement de commerce électronique multicanale sécurisée conforme à la norme PCI DSS. Elle vous permet d’accepter et de gérer des transactions de paiement en prenant en compte les règles métiers liées à votre activité (paiement à la livraison, paiement différé, paiement récurrent, paiement en plusieurs fois, …).

L'objectif de ce document est d'expliquer la mise en oeuvre de la solution Mise à jour des Données Cartes (MDC) proposée par le réseau CB, permettant de fournir le nouveau PAN ainsi que sa nouvelle date d’expiration en cas de renouvellement d'une carte (carte expirée ou mise en opposition).

A qui s’adresse ce document

Ce document s'adresse tout particulièrement aux commerçants faisant des paiements récurrents et/ou des abonnements et qui veulent demander les nouvelles données d’une carte en cas d’expiration ou d’opposition et ainsi ne pas avoir de rupture de paiement.

Les cas d'usage couverts sont :

abonnements
wallet
one-click

Ce document a pour objectif de vous aider à mettre en place le service MDC en décrivant les fonctionnalités et explique comment les mettre en œuvre avec la solution Worldline Sips.

Pour avoir une vue d’ensemble de la solution Worldline Sips, nous vous conseillons de consulter les documents suivants :

Présentation fonctionnelle
Guide de configuration des fonctionnalités

Note: Nous vous rappelons qu'il s'agit d'un service temps réel qui ne peut en aucun cas être utilisé comme un service batch.

Note: Un nombre maximum de PAN dans une requête ne doit pas être dépassé. Cette limite est en cours de définition et sera forcément inférieure à 10 000.

Prérequis

Le service MDC nécessite qu'un avenant soit signé avec votre acquéreur. Ainsi vous pourrez transmettre un formulaire de demande d’adhésion au service MDC à votre contact WL Sips habituel qui procédera alors à l'activation de l'option.

Nous vous conseillons également de mettre à jour vos CGV pour informer vos clients que vous vous laissez le droit de consulter le service Mise à jour des Données Cartes (MDC) pour mettre à jour les données des cartes.

Vue d’ensemble du service MDC

Ce service est proposé par CB, ce qui implique que seules les cartes porteurs CB ou co-badgées CB-XXX (CB-VISA, etc……) sont éligibles pour répondre aux demandes MDC.

Les types de cartes éligibles sont :

pure CB ;
CB/VISA ;
CB/MASTERCARD;
CB/VPAY;
CB/ELECTRON.

Nous préconisons d'utiliser ce service dans les cas suivants :

A moins de 15 jours de la date d’expiration de la carte ;
A plus de 4 mois de la date d’expiration de la carte.

Néanmoins, il est possible de solliciter le service après une Demande d’Autorisation refusée au motif de carte expirée, perdue ou volée (nativeAcquirerResponseCode = 33, 54, 41, 43).

Ce service est accessible via le connecteur Sips Office.

Mise en oeuvre

A partir d'un numéro de carte

Paramétrer la requête

En faisant appel à la méthode update du service accountUpdate, voici les données de la requête.

Nom du champ	Règle de valorisation
`cardScheme`	Nom du réseau associé à la carte. Doit être valorisé avec la valeur CB
`merchantId`	Identifiant de la boutique.
`interfaceVersion`	Valeur et numéro de version de l’interface utilisée. (Depuis AU_WS_2.49)
`seal`	Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).
`keyVersion`	Version de la clé secrète du commerçant utilisée pour calculer l’empreinte du message (clé stockée par le commerçant pour vérifier l’empreinte des notifications automatiques et manuelles).
`sealAlgorithm`	Algorithme de cryptage utilisé pour le calcul du sceau.
`panList`	Liste des PAN à renouveler. Note: Un nombre maximum de PAN dans une requête ne doit pas être dépassé. Il doit être inférieur à 10 000.

Analyser la réponse

Lorsque vous recevez la réponse, avant de l'analyser et suivre les conseils du tableau ci-dessous, vérifiez le seal. Le seal recalculé, doit être identique au seal reçu.

Les champs en retour sont :

État	Champs de la réponse	Actions à réaliser
Requête correcte et traitée et liste de numéros de cartes renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newPan` = nouveau PAN, `newCardExpiryDate` = date de validité de la nouvelle carte, `oldPan` = ancien PAN, `ausNativeAppCode` = 000, `ausResponseStatus` = ACCOUNT_UPDATED }	Traiter la requête de retour pour mettre à jour vos informations.
Requête correcte et traitée et liste de numéros de cartes non renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newPan` = vide, `newCardExpiryDate` = vide, `oldPan` = ancien PAN, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = ACCOUNT_NOT_UPDATED }	Traiter la requête de retour pour mettre à jour vos informations.
Requête correcte et traitée et liste de numéros de cartes non renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newPan` = vide, `newCardExpiryDate` = vide, `oldPan` = ancien PAN, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = INVALID_ACCOUNT_NUMBER }	Traiter la requête de retour pour mettre à jour vos informations.
Requête incorrecte	`ausReturnCode` = 03	Le marchand n'est pas enrollé au service MDC.
Requête incorrecte	`ausReturnCode` = 12	Cas possibles : - taille maximum de liste enntrée dépassée ; - plus qu’une liste renseignée en entrée; - présence de doublons dans la liste d’entrées. Consultez le champ `errorFieldName`, et corrigez la valeur incorrecte.
Requête incorrecte	`ausReturnCode` = 30	Cas possible : non-respect du format dans les listes en entrée. Consultez le champ `errorFieldName`, et corrigez la valeur incorrecte.
Requête incorrecte	`ausReturnCode` = 90 ou 99	Cas lié à une indisponibilité du service du réseau.
Requête incorrecte	`ausReturnCode` = différent de 00	Consultez le guide Sips Office correspondant au connecteur choisi (JSON, POST ou SOAP) pour analyser la réponse de WL Sips.

A partir d'un token

Paramétrer la requête

En faisant appel à la méthode update du service accountUpdate, voici les données de la requête.

Nom du champ	Règle de valorisation
`cardScheme`	Nom du réseau associé à la carte. Doit être valorisé avec la valeur CB
`merchantId`	Identifiant de la boutique.
`interfaceVersion`	Valeur et numéro de version de l’interface utilisée. (Depuis AU_WS_2.50)
`seal`	Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).
`keyVersion`	Version de la clé secrète du commerçant utilisée pour calculer l’empreinte du message (clé stockée par le commerçant pour vérifier l’empreinte des notifications automatiques et manuelles).
`sealAlgorithm`	Algorithme de cryptage utilisé pour le calcul du sceau.
`tokenPanList`	Liste des TokenPan à renouveler. Note: Un nombre maximum de TokenPan dans une requête ne doit pas être dépassé. Pour plus de détails contactez nous.

Analyser la réponse

Lorsque vous recevez la réponse, avant de l'analyser et suivre les conseils du tableau ci-dessous, vérifiez le seal. Le seal recalculé, doit être identique au seal reçu.

Les champs en retour sont :

État	Champs de la réponse	Actions à réaliser
Requête correcte et traitée et liste de tokens renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newTokenPan` = nouveau tokenPan, `newCardExpiryDate` = date de validité de la nouvelle carte, `oldTokenPan` = ancien tokenPan, `ausNativeAppCode` = 000, `ausResponseStatus` = ACCOUNT_UPDATED }	Traiter la requête de retour pour mettre à jour vos informations.
Requête correcte et traitée et liste de tokenPan non renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newTokenPan` = vide, `newCardExpiryDate` = vide, `oldTokenPan` = ancien tokenPan, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = ACCOUNT_NOT_UPDATED }	Traiter la requête de retour pour mettre à jour vos informations.
Requête correcte et traitée et liste de tokenPan non renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newTokenPan` = vide, `newCardExpiryDate` = vide, `oldTokenPan` = ancien tokenPan, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = INVALID_ACCOUNT_NUMBER }	Traiter la requête de retour pour mettre à jour vos informations.
Requête correcte et traitée et liste de tokenPan invalides	`ausReturnCode` = 00 `accountUpdateResultList` = { `newTokenPan` = vide, `newCardExpiryDate` = vide, `oldTokenPan` = ancien tokenPan, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = INVALID_TOKEN }	Le tokenPan est invalide
Requête incorrecte	`ausReturnCode` = 03	Le marchand n'est pas enrollé au service MDC.
Requête incorrecte	`ausReturnCode` = 12	Cas possibles : - taille maximum de liste enntrée dépassée ; - plus qu’une liste renseignée en entrée; - présence de doublons dans la liste d’entrées. Consultez le champ `errorFieldName` , et corrigez la valeur incorrecte.
Requête incorrecte	`ausReturnCode` = 30	Cas possible : non-respect du format dans les listes en entrée. Consultez le champ `errorFieldName` , et corrigez la valeur incorrecte.
Requête incorrecte	`ausReturnCode` = 40	Le marchand n’a pas l’option Token.
Requête incorrecte	`ausReturnCode` = 90 ou 99	Cas lié à une indisponibilité du service du réseau.
Requête incorrecte	`ausReturnCode` = différent de 00	Consultez le guide Sips Office correspondant au connecteur choisi (JSON, POST ou SOAP) pour analyser la réponse de WL Sips.

A partir d'un wallet

Paramétrer la requête

En faisant appel à la méthode update du service accountUpdate, voici les données de la requête.

Nom du champ	Règle de valorisation
`cardScheme`	Nom du réseau associé à la carte. Doit être valorisé avec la valeur CB
`merchantId`	Identifiant de la boutique.
`interfaceVersion`	Valeur et numéro de version de l’interface utilisée. (Depuis AU_WS_2.50)
`seal`	Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).
`keyVersion`	Version de la clé secrète du commerçant utilisée pour calculer l’empreinte du message (clé stockée par le commerçant pour vérifier l’empreinte des notifications automatiques et manuelles).
`sealAlgorithm`	Algorithme de cryptage utilisé pour le calcul du sceau.
`walletDataList`	Liste des WalletData à renouveler. Note: Un nombre maximum de WalletData dans une requête ne doit pas être dépassé. Pour plus de détails contactez nous.

Analyser la réponse

Lorsque vous recevez la réponse, avant de l'analyser et suivre les conseils du tableau ci-dessous, vérifiez le seal. Le seal recalculé, doit être identique au seal reçu.

Les champs en retour sont :

État	Champs de la réponse	Actions à réaliser
Requête correcte et traitée et liste de walletData renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newMerchantWalletId` = nouveau merchantWalletId, `newPaymentMeanId` = nouveau paymentMeanId, `newCardExpiryDate` = date de validité de la nouvelle carte, `oldMerchantWalletId` = ancien merchantWalletId, `oldPaymentMeanId` = ancien paymentMeanId, `ausNativeAppCode` = 000, `ausResponseStatus` = ACCOUNT_UPDATED }	Traiter la requête de retour pour mettre à jour vos informations.
Requête correcte et traitée et liste de walletData non renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newMerchantWalletId` = vide, `newPaymentMeanId` = vide, `newCardExpiryDate` = vide, `oldMerchantWalletId` = ancien merchantWalletId, `oldPaymentMeanId` = ancien paymentMeanId, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = ACCOUNT_NOT_UPDATED }	Traiter la requête de retour pour mettre à jour vos informations.
Requête correcte et traitée et liste de walletData non renouvelés	`ausReturnCode` = 00 `accountUpdateResultList` = { `newMerchantWalletId` = vide, `newPaymentMeanId` = vide, `newCardExpiryDate` = vide, `oldMerchantWalletId` = ancien merchantWalletId, `oldPaymentMeanId` = ancien paymentMeanId, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = INVALID_ACCOUNT_NUMBER }	Traiter la requête de retour pour mettre à jour vos informations.
Requête correcte et traitée et liste de walletData invalides	`ausReturnCode` = 00 `accountUpdateResultList` = { `newMerchantWalletId` = vide, `newPaymentMeanId` = vide, `newCardExpiryDate` = vide, `oldMerchantWalletId` = ancien merchantWalletId, `oldPaymentMeanId` = ancien paymentMeanId, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = INVALID_WALLET }	Le wallet identifié par merchantWalletId et paymentMeanId est invalide.
Requête correcte et traitée et liste de walletData invalides	`ausReturnCode` = 00 `accountUpdateResultList` = { `newMerchantWalletId` = vide, `newPaymentMeanId` = vide, `newCardExpiryDate` = vide, `oldMerchantWalletId` = ancien merchantWalletId, `oldPaymentMeanId` = ancien paymentMeanId, `ausNativeAppCode` = (voir le Dictionnaire des données), `ausResponseStatus` = INVALID_PAYMENTMEAN_FOR_WALLET }	Le moyen de paiement du wallet identifié par merchantWalletId et paymentMeanId n'est pas une carte.
Requête incorrecte	`ausReturnCode` = 03	Le marchand n'est pas enrollé au service MDC.
Requête incorrecte	`ausReturnCode` = 12	Cas possibles : - taille maximum de liste enntrée dépassée ; - plus qu’une liste renseignée en entrée; - présence de doublons dans la liste d’entrées. Consultez le champ `errorFieldName` , et corrigez la valeur incorrecte.
Requête incorrecte	`ausReturnCode` = 30	Cas possible : non-respect du format dans les listes en entrée. Consultez le champ `errorFieldName` , et corrigez la valeur incorrecte.
Requête incorrecte	`ausReturnCode` = 40	Le marchand n’a pas l’option OneClick.
Requête incorrecte	`ausReturnCode` = 90 ou 99	Cas lié à une indisponibilité du service du réseau.
Requête incorrecte	`ausReturnCode` = différent de 00	Consultez le guide Sips Office correspondant au connecteur choisi (JSON, POST ou SOAP) pour analyser la réponse de WL Sips.

Besoin d'aide ?

Consulter la faq