Introduction

WL Sips est une solution de paiement e-commerce 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 fractionné, …).

L’objectif du présent document est d’expliquer l’intégration du service WL Sips Account Updater.

A qui s’adresse ce document

Ce document a pour objectif de vous aider à intégrer le service WL Sips Account Updater.

WL Sips Accont Updater est basé sur les services de mise à jour de compte fournis par les acquéreurs.

Avant d’intégrer le service, veuillez vérifier auprès de votre Account Support Manager la disponibilité de ce service pour votre acquéreur.

A propos du service WL Sips Account Updater

Sans doute utilisez-vous un système de paiements récurrents pour facturer vos services et produits.

Les exemples typiques sont :

  • paiement de régimes d'assurance,
  • paiement de services de dépannage et de recouvrement,
  • journaux et systèmes d'abonnement.

Bien que ce système soit pratique pour vous et les titulaires de carte, il existe un inconvénient majeur : les cartes plastiques sont réémises régulièrement, et vous pouvez perdre facilement la trace des détails de la carte du titulaire, et les impayés obtenus peuvent se révéler inacceptables pour toutes les parties.

L’objectif du service Account Updater, qui a été mis en œuvre par les émetteurs et les acquéreurs, vise à résoudre ce problème.

Les objectifs du service WL Sips Account Updater sont les suivants :

  • Vous fournir un moyen automatisé de mettre à jour les informations carte de vos clients, leur permettant de soumettre des paiements récurrents.
  • Aider à minimiser le risque des impayés.
  • Permettre aux titulaires de carte de demander des « arrêts de paiement » auprès des émetteurs.
  • Fournir aux émetteurs de cartes et aux acquéreurs une proposition plus solide pour vos futurs clients potentiels.

Principes généraux

Processus général du service Account Updater :

Le service WL Sips Account Updater est basé sur l'échange de fichiers hors ligne.

  1. Vous envoyez les fichiers de consultation contenant une liste de cartes à vérifier par WL Sips via FTP. Le fichier de requête doit être transféré dans un fichier d'archive au format ZIP. Le nom de ce fichier d'archive doit être AUSREQxx.ZIP avec xx ce qui est un numéro compris entre 01 et 99. Un fichier d'archive ne doit contenir qu'un seul fichier de requête. Vous devez utiliser le modèle suivant pour le nom du fichier :

    [ AUS ].[ Alias ].[ file_ID ]_REQ.[ Timestamp ] avec :

    [AUS] Indiquant qu'il s'agit d'un fichier de requête pour « AUS batch »
    [Alias] Merchant_ID qui est l'identifiant du commerçant de WL Sips .
    [file_ID] File_ID du fichier de requête, un nombre à six chiffres où les deux premiers chiffres correspondent à la valeur XX du fichier d’archive.
    [Timestamp] Date du fichier au format AAMMJJ & Heure du fichier au format HHMMSS.

  2. Le fichier de requête est traité par WL Sips . Avant de transmettre le fichier à l'acquéreur, WL Sips vérifie la validité et le format du fichier.
  3. Une fois que toutes les réponses sont renvoyées à WL Sips , WL Sips génère un fichier de réponse contenant une réponse pour chaque carte du fichier de requête.
    1. si vous envoyez des tokens ou des pans, WL Sips vous renvoie les tokens mis à jour dans le fichier de réponse à votre requête.
    2. si walletId / paymentMeanId, WL Sips met à jour les cartes dans le wallet.

    Un code de réponse est associé à chaque carte. Pour le code de réponse, veuillez vous référer au paragraphe Codes réponse ..

  4. WL Sips envoie ce fichier de réponse sur votre compte FTP.
  5. Vous téléchargez le fichier de réponse à partir du compte FTP fourni par Worldline .
  6. Le fichier de réponse est transféré dans un fichier archive au format ZIP. Le nom de ce fichier d'archive est AUSREQxx.ZIP avec xx qui correspond à la valeur liée à l'archive du fichier de requête. Un fichier d'archive comprend un seul fichier de requête. Votre fichier de réponses utilise le modèle suivant pour le nom de fichier :

    [ AUS ].[ Alias ].[ file_ID ]_REQ.[ Timestamp ] avec :

    [AUS] Indiquant qu'il s'agit d'un fichier de requête pour « AUS batch ».
    [Alias] Merchant_ID est l'identifiant du commerçant de WL Sips .
    [file_ID] File_ID du fichier de requête, un nombre à six chiffres où les deux premiers chiffres correspondent à la valeur XX du fichier d’archive.
    [Timestamp] Date du fichier au format AAMMJJ & Heure du fichier au format HHMMSS.

  7. Le fichier de réponses est détruit après le premier téléchargement réussi.

Vous devez prendre en compte les mises à jour pour les paiements ultérieurs.

Il existe 3 façons d’identifier une carte dans votre fichier de requête :

  • via un PAN
  • via un Token
  • via un couple Wallet ID/Payment mean ID

Attention, si vous choisissez d'utiliser un PAN ou un token pour identifier la carte, la même carte inscrite dans le wallet ne sera pas mise à jour.

Pour plus de détails sur les fichiers de requête et de réponse, veuillez vous référer au paragraphe Spécifications du fichier réponse et du fichier requête .

Vous recevez autant de fichiers de réponses que de fichiers de requêtes que vous envoyez. Si vous envoyez un fichier de requête contenant uniquement des cartes VISA, vous devriez recevoir un fichier de réponse environ 2 heures après, sinon vous recevrez le fichier de réponse environ 24 heures après. Le délai maximum est de 25 heures.

La fréquence

Le service WL Sips est disponible six jours par semaine (du lundi au samedi), entre 09h00 et 17h00 (CET). Vous pouvez soumettre des fichiers quand vous le souhaitez, que ce soit tous les jours, toutes les semaines ou tous les mois.

De plus, vous pouvez soumettre un ou plusieurs fichiers de requête par jour. WL Sips enverra une réponse pour chacun des fichiers de requête après maximum 25 heures.

Limitations

Rappel : les réseaux VISA et MASTERCARD limitent le nombre maximum d'enregistrements à cent mille enregistrements par fichier requête.

Description des fichiers de requête et de réponse

Spécification de votre fichier de requête

Description

Entête du fichier

Chapms Format Présence Description
Le nom de la balise est fixé à la valeur « header ». ANS20 Obligatoire Indique l’enregistrement d’un en-tête.
merchantId N15 Obligatoire En tant qu’identifiant de la boutique, cette valeur vous est fournie par WL Sips lors de l’inscription à la boutique.
date date XML Obligatoire La date à laquelle le fichier a été créé dans votre fuseau horaire (AAAA-MMJJ + hhmm).
heure heure XML Obligatoire Heure à laquelle le fichier a été créé dans votre fuseau horaire (hh: mm: ss + hhmm).
merchantVolumeNumber AN6 Obligatoire
Identifie le fichier de manière unique.

Que des espaces ou que des zéro est interdit

Les 2 premiers chiffres du numéro de volume sont attribués par Worldline . Les 4 autres chiffres sont attribués par vous. Veuillez contacter votre Account Support Manager pour obtenir le numéro attribué par Worldline
accountUpdateType ANS20 Obligatoire Le type d'identifiant du compte à mettre à jour.
Valeurs :
  • PAN
  • TOKEN
  • MERCHANTWALLET

Corps

Chapms Format Présence Description
Le nom de la balise est fixé à la valeur « updateAccount ». ANS20 Obligatoire
recordSequence N6 Obligatoire L'attribut indique le numéro de ligne vous permettant de réconcilier la réponse avec la requête.
accountUpdateValue ANS35 Conditionnel L'identifiant du compte à mettre à jour.
Obligatoire : si accountUpdateType =PAN, alors renseigner le pan.
Obligatoire : si accountUpdateType =TOKEN, alors renseigner le token
Facultatif : si accountUpdateType = MERCHANTWALLET, alors renseigner le pan masqué.
panExpiryDate N6 (AAAAMM) Conditionnel Date d'expiration de la carte.
Obligatoire : si accountUpdateType =PAN/TOKEN
merchantWalletId ANS21 Conditionnel Identifiant du wallet du client.
Obligatoire: si accountUpdateType =MERCHANTWALLET
paymentMeanId N6 Conditionnel Identfiant du moyen de paiement dans le wallet du client.
Obligatoire : si accountUpdateType =MERCHANTWALLET
amount N12 Facultatif Montant de la transaction (exprimé dans la plus petite unité de la devise)
currencyCode N3 (ISO4217) Facultatif Code devise de transaction
merchantTransaction DateTime ANS25 (ISO8601) Facultatif Date prévue de la transaction financière
transactionFrequency N1 Facultatif Fréquence de transaction
0 – Ad Hoc
1 – quotidien
2 – hebdomadaire
3 – toutes les 2 semaines
4 – mensuel
5 – trimestriel
6 – semestriel
7 – annuel
8 – autre (fréquence régulière)
merchantPolicyReference Number AN20 Obligatoire Votre numéro de contrat / de police pour l'accord conclu entre vous et le titulaire de la carte auquel se rapporte le paiement récurrent.

fin de fichier

Chapms Format Présence Description
Le nom de la balise est fixé à la valeur « end ». ANS20 Obligatoire Indique l'enregistrement final.
numberOfRecords N6 Obligatoire Nombre d'enregistrements de requête dans le fichier.
Veuillez vous référer au paragraphe Traitement des codes réponse .

Exemple de votre fichier de requête

      <?xml version="1.0" encoding="UTF-8"?>
<file>
    <header>
        <merchantId>00000000000012</merchantId>
        <date>2016-10-25+02:00</date>
        <time>09:30:15+02:00</time>
        <merchantVolumeNumber>000005</merchantVolumeNumber>
        <accountUpdateType>PAN</accountUpdateType>
    </header>
    <body>
        <updateAccount recordSequence="1">
            <accountUpdateValue>5571000001001234</accountUpdateValue>
            <panExpiryDate>201805</panExpiryDate>
            <merchantPolicyReferenceNumber>01234567890123456789</merchantPolicyReferenceNumber>
        </updateAccount>
        <updateAccount recordSequence="2">
            <accountUpdateValue>5671000001004321</accountUpdateValue>
            <panExpiryDate>201610</panExpiryDate>
            <merchantPolicyReferenceNumber>98765432100123456789</merchantPolicyReferenceNumber>
        </updateAccount>
    </body>
    <end nbRecord="2"/>
</file>
    

Spécification de votre fichier de réponse

Description

Entête fichier

Chapms Format Présence Description
Le nom de la balise est fixé à la valeur « header ». ANS20 Obligatoire Indique l’enregistrement d’un entête.
merchantId N15 Obligatoire Identifiant de la boutique, cette valeur vous est fournie par WL Sips lors de l’inscription à la boutique.
Date Date XML Obligatoire
La date à laquelle le fichier a été créé dans votre fuseau horaire (AAAA-MMJJ + hhmm). Avec le format de fichier CSV, le fuseau horaire est AAAA-MM-JJ + hhmm.
Heure Heure XML Obligatoire
L'heure à laquelle le fichier a été créé dans votre fuseau horaire (hh: mm: ss + hhmm). Avec le format de fichier CSV, le fuseau horaire est AAAA-MM-JJ + hhmm.
merchantVolumeNumber AN6 Obligatoire Votre numéro de volume que vous avez envoyé dans la requête.
accountUpdateType ANS20 Obligatoire Le type d'identifiant du compte à mettre à jour.
Valeurs :
  • PAN
  • TOKEN
  • MERCHANTWALLET
processingResponseCode AN2 Obligatoire Veuillez vous référer au paragraphe Traitement des codes réponse e.

Corps

Champs Format Présence Description
Le nom de la balise est fixé à la valeur « updateAccount ». ANS20 Obligatoire
recordSequence N6 Obligatoire L'attribut indique le numéro de ligne vous permettant de réconcilier la réponse avec la requête.
accountUpdateValue ANS35 Conditionnel L'identifiant du compte à mettre à jour.
Renseigné seulement si accountUpdateResponseCode =“01”

si accountUpdateType =PAN, alors valeur du pan

si accountUpdateType =TOKEN, alors valeur du token.
si accountUpdateType = MERCHANTWALLET, alors valeur du pan masqué.
panExpiryDate N6 (AAAAMM) Conditionnel Date d'expiration de la carte.

Renseigné seulement si accountUpdaterResponseCode =“01” et accountUpdateType =PAN/TOKEN

merchantWalletId ANS21 Conditionnel Identifiant du wallet du client.

Renseigné seulement si accountUpdateResponseCode =“01” et accountUpdateType =MERCHANTWALLET

paymentMeanId N6 Conditionnel Identifiant du moyen de paiement dans le wallet du client.
Renseigné seulement si accountUpdateResponseCode =“01”.
Obligatoire si accountUpdateType =MERCHANTWALLET.
accountUpdateResponseCode AN2 Obligatoire Code de réponse du service Account Updater.
Veuillez vous référer au paragraphe Codes réponse .
acquirerNativeResponseCode ANS10 Facultatif Code de réponse renvoyé par l'acquéreur, dans sa propre codification, lors d'une requête de service de mise à jour de compte.
Veuillez vous référer au paragraphe Codes réponse .
schemeResponseCode AN3 Facultatif Code de réponse renvoyé par le réseau VISA ou MASTERCARD.

Fin de fichier

Chapms Format Présence Description
Le nom de la balise est fixé à la valeur « end ». ANS20 Obligatoire Indique l'enregistrement final.
numberOfRecords N6 Obligatoire Nombre d'enregistrements de requête dans le fichier.
Le nombre doit être :
  • le même avec votre requête,
  • ou zéro, si le fichier n'est pas traité par WL Sips .

Exemple de votre fichier de réponse

      <?xml version="1.0" encoding="UTF-8"?>
<file>
    <header>
        <merchantId>00000000000012</merchantId>
        <date>2016-10-25+02:00</date>
        <time>09:30:15+02:00</time>
        <merchantVolumeNumber>000005</merchantVolumeNumber>
        <accountUpdateType>MERCHANTWALLET</accountUpdateType>
        <processingResponseCode>00</processingResponseCode>
    </header>
    <body>
        <updateAccount recordSequence="1">
            <merchantId>00000000000012</merchantId>
            <accountUpdateType>MERCHANTWALLET</accountUpdateType> 
            <accountUpdateValue>5571########1234</accountUpdateValue>
            <panExpiryDate>201805</panExpiryDate>
            <merchantWalletId>11112222333344441</merchantWalletId>
            <paymentMeanId>112345</paymentMeanId>
            <accountUpdateResponseCode>01</accountUpdateResponseCode>
            <acquirerNativeResponseCode>01</acquirerNativeResponseCode>
        </updateAccount>
    </body>
    <end nbRecord="1"/>
</file>
    

Traitement des codes réponse

Code Description
00 Fichier traité correctement.
03 Contrat du commerçant invalide
06 Le nombre d'opérations dépasse le montant maximum possible. Le nombre maximum d'opérations est atteint.
07 Le nombre d'enregistrements est différent du nombre indiqué dans le champ nbRecord .
30 Erreur de format
40 Vous n'êtes pas inscrits au service WL Sips Account Updater Service
90 Le service est temporairement indisponible
99 Problème temporaire au niveau du serveur WL Sips .

Codes réponse

Dans la réponse, un code de réponse est affecté à chaque carte du fichier de requête.

accountUpdateResponseCode Description Action recommandée code réponse VISA code réponse MasterCard Code réponse d’erreur MasterCard
00 Pas de changement Facturer le titulaire de la carte en utilisant les détails existants. 01- Pas de changement V – Pas de changement
04 Pas de changement Réessayer dans 7 jours. 03 – PAN en cours de basculement vers une nouvelle banque. Réessayer dans 7 jours.
01 Mise à jour du compte fournie Valider les données de mise à jour et facturer le titulaire de carte en utilisant de nouveaux détails. 00 - Nouveaux détails trouvés

04 - Nouvelle date d'expiration trouvée dans le service de mise à jour de Visa

05 - Une date d'expiration plus ancienne trouvée dans le service de mise à jour de Visa.
A- MISE A JOUR. Correspondance établie, données de mise à jour fournies, inclut le compte de remplacement, marque inversée et portefeuille inversé.

E - EXPIRATION. Correspondance établie, date d'expiration changée

06 Mise à jour du compte fournie Si les données mises à jour par le service de mise à jour de compte sont de mauvaise qualité, contacter le titulaire de la carte pour la mise à jour. 06 - Un PAN plus récent a été trouvé mais il a déjà expiré

07 - Une date d'expiration plus récente a été trouvée mais elle est déjà expirée.
02 Autorisation retirée ou suspendue Contacter le titulaire de la carte – ne pas facturer 51 - Le Paiement Récurrent doit être stoppé au niveau du PAN

52 - Le Paiement Récurrent doit être stoppé au niveau du commerçant

53 - Le Paiement Récurrent doit être stoppé au niveau du MPRN.
000200 - Le titulaire de la carte a demandé un arrêt de paiement pour ce commerçant. Aucune mise à jour ne peut être fournie. Contacter le titulaire de la carte.
05 Indisponible Facturer le titulaire de la carte en utilisant les détails existants. 18 - Emetteur n'a pas souscrit au service Account Updater

19 - PAN introuvable dans le service de mise à jour de Visa.

21 - BIN ne participant pas au service de mise à jour de Visa.

27 - Le titulaire de carte a choisi de se retirer du service Account Updater de Visa.
U - Inconnu
03 Compte fermé Contacter le titulaire de la carte – ne pas facturer 02 - PAN est basculé à une banque autre que Visa

20 – compte fermé ou indisponible temporairement pour des transactions.
C – CONTACT. Correspondance établie, compte fermé.
12 Erreur de soumission Vérifiez l’exactitude des données et resoumettre. Contacter le titulaire de la carte si nécessaire. 12 - Champ PAN invalide

14 - Champ MONTANT invalide

16 - Champ FREQUENCE invalide

17 - Champ DATE invalide

23 - MPRN invalide

24 - Devise de transaction invalide

26 - Format de date d'expiration invalide
Espaces - si la requête a une erreur 000101 - Erreur lors de la soumission - Numéro de compte non numérique

000102 - Erreur lors de la soumission - Chiffre de contrôle incorrect sur le compte.

000103 - Erreur lors de la soumission - Date d'expiration de la carte invalide.

000104 - Erreur lors de la soumission – Commerçant non enregistré
A0 Réponse non reçue de l'acquéreur Resoumettre