WL SIPS DOCS

Release 22.3

aller directement au contenu

Rechercher par mots clés

Intégration American Express

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

WL 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étier liées à votre activité (paiement à la livraison, paiement différé, paiement récurrent, paiement en plusieurs fois…).

L’objectif du présent document est d’expliquer l'intégration du moyen de paiement American Express dans WL Sips.

Ce document a pour objectif de vous aider à implémenter le moyen de paiement American Express sur votre site de commerce électronique.

Il comprend :

  • des informations fonctionnelles à votre attention ;
  • des instructions d'implémentation à destination de votre équipe technique.

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

  • Présentation fonctionnelle
  • Guide de configuration des fonctionnalités

La carte American Express est une carte de paiement internationale émise par et associée au réseau de paiement American Express.

Le réseau American Express offre un large éventail de cartes personnelles et professionnelles, mais surtout il permet aux clients de différer le règlement de la somme due.

American Express a aussi adhéré au programme 3-D Secure, sous marque Safekey, afin de réduire les risques de fraude sur les achats en ligne des clients.

Pour payer avec une carte du réseau American Express, le titulaire de carte doit fournir les renseignements détaillés sur sa carte, à savoir :

  • Le numéro de carte ;
  • La date d’expiration ;
  • Le cryptogramme visuel (ou le code de sécurité de la carte, appelé CID ou 4DBC dans le cas d’American Express) ;
  • Si la carte du titulaire et votre identifiant de commerçant sont enrôlés Safekey, le client devra saisir un code dynamique à usage unique, généralement reçu sur son mobile.
Canaux de paiement
Internet V Canal de paiement par défaut
MAIL_ORDER, TELEPHONE_ORDER V Authentification SafeKey non applicable
Télécopie V Authentification SafeKey non applicable
SVI V Authentification SafeKey non applicable
Typologies de paiement
Paiement immédiat X
Paiement en fin de journée V Méthode par défaut
Paiement différé V Dans le cas de l’authentification SafeKey, le délai de capture est limité à 6 jours.
Paiement à l'expédition V Dans le cas de l’authentification SafeKey, le délai de capture est limité à 6 jours.
Paiement en plusieurs fois V Seulement la 1ère transaction sera authentifiée au moyen de SafeKey.
Paiement par abonnement V Authentification SafeKey non applicable
Paiement par fichier V Authentification SafeKey non applicable
Paiement OneClick V
Gestion des devises
Acceptation multidevise V Selon votre contrat
Règlement en devise V Selon votre contrat

La durée d’autorisation pour les cartes American Express dépend de votre acquéreur. Par défaut, elle est de 6 jours.

Dans le cas d’un paiement différé d’une durée de 6 jours ou moins, WL Sips effectue auprès de l’acquéreur une demande d’autorisation sur le montant total de la transaction, qui sera ensuite remisée en fonction de la modalité de paiement demandée.

Dans le cas d’un paiement différé d’une durée supérieure à 6 jours, WL Sips effectue deux demandes d’autorisation auprès de l’acquéreur :

  • la 1ère demande d’autorisation appelée « demande de renseignement », effectuée en ligne, qui permet de vérifier le statut et la validité de la carte sans en impacter le plafond d’autorisation ;
Note: la demande de renseignement doit être supportée par votre acquéreur. Dans le cas contraire, une autorisation réelle d'un petit montant est effectuée (par exemple : 2,00 EUR pour la zone euro) afin de vérifier la validité de la carte.
  • une 2ème requête d’autorisation du montant réel de la transaction au moment du prélèvement de la banque.

Pour les canaux INTERNET, MAIL_ORDER et TELEPHONE_ORDER, uniquement sur l’interface Sips Office et Sips Office Batch, vous pouvez effectuer une demande de renseignement de votre propre initiative (non conditionnée au délai du paiement différé). Pour ce faire, il vous suffit de valoriser le montant de la transaction à « 0 ». WL Sips effectuera alors une demande de renseignement auprès de l’acquéreur, la transaction sera stockée dans le système d’information WL Sips dans un état final, et ne sera pas remisée en banque.

Attention: la demande de renseignement doit être supportée par votre acquéreur. Dans le cas contraire, une tentative de demande de renseignement à votre initiative entraînera une demande d’autorisation standard d’un montant de « 0 ».

Lors d’un paiement, il arrive parfois que la transaction en cours ne puisse être finalisée. C’est le cas, par exemple, lorsque l'un des acteurs du réseau bancaire rencontre une défaillance lors du traitement d'une demande d'autorisation. Le serveur WL Sips va émettre un message d’annulation de la transaction qui est appelé redressement. Ce message permet à la banque émettrice de mettre à jour, si nécessaire, les encours de la carte du titulaire.

Attention: pour fonctionner, le redressement du plafond en cas d’erreur nécessite d’être supporté par l’acquéreur.

Les paiements sont remis vers American Express conformément aux modalités de paiement définies par vous-même. En standard, la remise en banque est déclenchée la nuit à partir de 22h00, fuseau horaire CET (heure d’Europe Centrale), via un échange de fichier avec American Express.

American Express a créé le programme Safekey pour améliorer la fiabilité des transactions. Il est similaire au programme 3-D Secure proposé par Visa et MasterCard. Dans ce programme, il est demandé au client qui tente de payer par une carte American Express de s’authentifier en tant que titulaire de carte. Cette procédure d’authentification implique American Express qui joue le rôle tant de l’acquéreur que de l’émetteur de la carte.

Si toutes les parties suivent les règles du processus d’authentification, American Express peut vous garantir le paiement de la transaction. WL Sips ne fournit aucune information sur la garantie de paiement offerte par American Express.

Les résultats de la procédure d’authentification Safekey peuvent déclencher la relégation automatique de la transaction. Cela signifie que, dans certaines circonstances, la transaction est traitée comme si aucune procédure d’authentification Safekey n’avait été effectuée.

La relégation automatique est déclenchée par l’une ou l’autre de ces situations :

  • la carte utilisée n’est pas marquée comme inscrite dans le programme d’authentification Safekey ;
  • un problème technique (p.ex. défaillance temporaire du service) survient lors de la procédure d’authentification Safekey.

Dans le cas d’une demande de paiement différé avec une authentification Safekey, le délai ne pourra excéder 6 jours (si le délai demandé par le commerçant excède ce délai, il sera automatiquement ramené à 6 jours par WL Sips pendant le processus de paiement).

Lorsque vous souscrivez au programme d’authentification Safekey, l’ensemble des paiements pour lesquels le programme est applicable sera soumis à cette authentification. Il est cependant possible de désactiver le programme d’authentification Safekey à la demande, via l’alimentation d’un flag dans la requête.

Attention: vous devez auparavant être inscrit à l’option permettant de désactiver Safekey à la demande.
Cette désactivation à la demande n’est possible que sur l’interface « Sips Paypage ».
Aucun transfert de responsabilité ne s’appliquera en cas de désactivation de l’authentification Safekey.

La demande de redressement consiste à annuler la modification du plafond d'autorisation de la carte du porteur.

Cette demande de redressement est toujours liée à une demande d'autorisation.

Tip: la demande de redressement n'est possible que pour les acquéreurs le supportant (nous contacter pour connaître la liste).

La demande de redressement est envoyée à l'acquéreur dans les cas suivants :

  • le commerçant annule complètement la transaction (soit via une annulation totale, ou via une succession d'annulations partielles);
  • le serveur d'autorisation de l'acquéreur n'a pas répondu favorablement à une demande d'autorisation pour les raisons suivantes : « approuver après identification » ou « approuvée partiellement » ;
  • aucune réponse n'a été reçue suite à une demande d'autorisation (timeout).

Pour le moyen de paiement American Express, la demande de crédit porteur doit toujours faire suite à une transaction de débit originelle.

À la différence d'une demande de remboursement, la demande de crédit porteur permet de créditer le compte d'un client dont la transaction d'origine n'a pas été réalisée sur WL Sips.

American Express se réserve le droit de vérifier la cohérence des demandes de crédit porteur en réalisant certaines vérifications :

  • le solde de votre compte American Express doit être positif;
  • la proportion du nombre de demandes de crédit porteur par rapport au nombre de demandes de débit doit être cohérente;
  • ...

En cas de suspicion, American Express se réserve le droit de revenir vers vous.

Tip: Nous vous invitons à vous rapprocher de votre contact American Express pour connaître toutes les précautions d'usage.

Afin de proposer le moyen de paiement American Express sur votre site Web, vous devez souscrire un contrat de Vente A Distance auprès d'American Express. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.

Toutes les devises pourront être acceptées par WL Sips (Merci de vous référer au paragraphe 'currencyCode' du Dictionnaire des données) à condition qu'elles soient prévues dans un des contrats que vous avez conclus avec American Express. Veuillez noter que les contrats American Express sont des contrats à devise unique. Cela signifie que vous devez signer un contrat d’acceptation American Express pour chaque devise souhaitée.

Si vous utilisez plusieurs canaux de paiement, vous devrez ouvrir un contrat American Express par canal.

Note: Ainsi, si vous utilisez plusieurs canaux, par exemple MOTO et Internet/In-App, ainsi que plusieurs devises, par exemple Euros et Dollars, il vous faudra quatre contrats :
  • un contrat MOTO et Euros
  • un contrat MOTO et Dollars
  • un contrat Internet/In-App et Euros
  • un contrat Internet/In-App et Dollars

WL Sips vous offre trois solutions pour intégrer le moyen de paiement American Express :

  • Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.
  • Sips Office qui vous laisse la possibilité d’afficher vous-même vos pages de paiement et qui fonctionne par un dialogue de serveur à serveur.
  • Sips Office Batch qui vous permet de traiter des paiements par échange de fichiers.

Les modes de remise disponibles pour une transaction American Express sont les suivants :

  • Mode annulation : mode par défaut, il permet de remiser la transaction à une date prédéfinie, appelée délai de capture. Lorsque ce délai de capture est atteint, la remise est automatiquement envoyée. Ce délai est paramétré via le champ captureDay, sa valeur par défaut est 0 (paiement en fin de journée).
  • Mode validation : vous devez valider la transaction pour déclencher la remise. Un délai de capture doit aussi être défini. Lorsque ce délai de capture est atteint ou dépassé, vous ne pourrez plus valider la transaction, celle-ci expirera donc automatiquement.

Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :


description des status possibles pour une transaction American Express

En mode annulation (captureMode = AUTHOR_CAPTURE), si la transaction est acceptée et que le délai de capture (captureDay) n’est pas dépassé, la transaction passe en statut TO-CAPTURE. S’il est dépassé, la transaction passe en statut TO_AUTHORIZE. En mode validation (captureMode = VALIDATION), si la transaction est acceptée et que le délai de capture (captureDay) n’est pas dépassé, la transaction passe en status TO-VALIDATE. S’il est dépassé, la transaction passe en status TO_REPLAY. Quel que soit le mode de capture, si la transaction est refusée (responseCode différent de 00), elle passe en status REFUSED.

La cinématique de paiement pour Sips Paypage est décrite ci-dessous :


étapes d'un paiement American Express via Paypage

1) Le client procède au paiement. 2) Il est redirigé vers la page de sélection du moyen de paiement hébergée chez WL Sips, il sélectionne American Express et saisit son numéro de carte. 3) Il est redirigé vers la page ACS où il s'authentifie. 4) Il est redirigé sur une page WL Sips. 5) S'il clique sur le bouton de retour à la boutique, il est redirigé vers votre site Web ce qui délenche l'envoi de la réponse manuelle. 6) WL Sips envoie une réponse automatique.

Le système d’acquisition d’AMEX propose un système spécifique pouvant effectuer des vérifications additionnelles sur la transaction, nommé AMEX Enhanced Authorization (AMEX-EA).

Ce système se base sur un ensemble de données optionnelles de la requête.

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données). L’autorisation est refusée pour un motif non lié à la fraude.
Si vous n’avez pas opté pour l’option « nouvelle tentative de paiement » (pour plus de détails veuillez consulter le Guide de configuration des fonctionnalités), vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus Soft Decline acquirerResponseCode = A1 L’acquéreur a refusé le paiement car il n’y a pas eu d'authentification 3-D Secure.
Veuillez retenter le paiement en activant l'authentification 3-D Secure.
Refus nombre max essais atteint responseCode = 75 Le client a fait plusieurs tentatives qui ont toutes échoué.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Le processus de paiement pour Sips Office est décrit ci-dessous :


étapes d'un paiement American Express via Office

1) Vous collectez les coordonnées de paiement du client via une page dédiée sur votre site. 2) Vous vérifiez l’enrôlement 3-D Secure de la carte en envoyant une requête de vérification à WL Sips et WL Sips vous renvoie une réponse contenant le l’URL de l’ACS. 3) Vous redirigez le client vers l’URL de l’ACS de sa banque. 4) Vous récupérez les données de l'authentification du client. 5 ) Vous transmettez la demande d'autorisation à WL Sips et WL Sips vous renvoie une réponse contenant le résultat du paiement. 6) Vous affichez le résultat du paiement à votre client.

Il est possible d'initier des paiements American Express avec la méthode cardCheckEnrollment du service CheckOut. Les champs suivants sont utilisés pour envoyer les informations spécifiques à ce moyen de paiement :

Nom du champ Remarques / règles
cardNumber Obligatoire
cardExpiryDate Obligatoire
cardCSCValue Obligatoire, sur 4 positions (4DBC)
paymentMeanBrand Doit être valorisé avec AMEX.

Merci de vous référer au paragraphe paiement 3-D Secure via le connecteur Sips Office pour mettre en œuvre les autres étapes d'un paiement 3-D Secure.

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données). L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Merci de vous référer au document Guide 3DS pour analyser les informations d'authentification.

Les opérations suivantes sont disponibles sur les transactions American Express :

Gestion de caisse
Annulation V
Validation V
Remboursement V
Duplication V
Recyclage X
Crédit V

Le diagramme ci-dessous vous permet de savoir quelle opération de gestion de caisse est disponible lorsqu'une transaction est dans un état donné :


Schéma trop complexe à décrire, merci de contacter le support sips@worldline.com

Les journaux mis à disposition par WL Sips vous permettent d’avoir une vision exhaustive et consolidée de vos transactions, opérations de caisse, situation comptable et impayés. Vous pouvez utiliser ces informations pour enrichir votre système d’information.

La disponibilité des transactions American Express pour chaque type de journal est récapitulée dans le tableau ci-dessous :

Disponibilité des journaux
Journal des transactions V
Journal des opérations V
Journal de rapprochement des transactions V
Journal de rapprochement des impayés V
Note: pour les transactions American Express, le champ paymentMeanBrand est renseigné avec la valeur AMEX.
Attention: afin de pouvoir bénéficier des journaux de rapprochements WL Sips pour vos transactions American Express , il est nécessaire de faire parvenir une demande à American Express. Merci de vous rapprocher de votre interlocuteur American Express habituel.

Vous pouvez consulter vos transactions American Express et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.



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