WL SIPS DOCS

Release 24.2

aller directement au contenu

Rechercher par mots clés

Mise à jour des Données Carte

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

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).

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.

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.

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.

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.

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.

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.

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.

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.

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.

Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation WL Sips.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres