Contenu
Plus d'informations
Cette page est une présentation des fonctionnalités du moyen de paiement American Express Recurring (Amex Recurring) disponible sur Monext Online. Ce moyen de paiement est particulièrement adapté aux paiements récurrents et par abonnement.
En effet, sur la plateforme de paiement American Express nommée « SmartBill », American Express propose aux marchands de créer un alias de carte qui lui permettra de débiter la carte associée sans à devoir se préoccuper de la vie de la carte : expiration, type ou résiliation d’une carte.
Le moyen de paiement « Amex Recurring » vous permet de débiter une carte American Express sur simple demande de paiement par alias. Le consommateur est sollicité uniquement lors de la phase d’enrôlement pour enregistrer sa carte.
Les Web Services que vous pourrez utiliser :
Ce moyen de paiement est disponible avec l'API WebPayment (widget/PWPv2).
Les différents type de notification (notificationType), les paramètres ainsi que le Web Service à appeler en fonction du type de notif et des paramètres :
Pour pouvoir utiliser le moyen de paiement AMEX Recurring, vous devez dans un premier temps enregistrer les données cartes American Express sur Monext Online :
Suite à cet enregistrement, à partir des données que vous nous avez transmises, Monext Online créé un alias et soumet à American Express une demande d’enrôlement par fichier sous 24h.
Les fonctionnalités de paiement récurrent par American Express reposent sur la création d’un alias pour identifier une carte de paiement.
Vous choisissez un identifiant unique par consommateur. Puis, vous nous transmettez à Monext Online cet identifiant dans un champ intitulé « walletID » correspondant à un numéro de portefeuille. Monext Online attribue à chaque carte contenue dans le portefeuille de votre consommateur un numéro index de carte (par exemple 1, 2, 3 etc.).
L’alias de carte transmis à American Express est créé par Monext Online lors de l’enregistrement des données cartes dans un portefeuille Monext Online par la concaténation du numéro de portefeuille et de l’index de la carte.
ALIAS Amex = walletID + cardIndex
Vous nous communiquez le numéro de portefeuille. Nous vous recommandons d’utiliser l’identifiant consommateur de votre système d’information comme identifiant du portefeuille client. L’index de la carte est communiqué par Monext Online. Pour que l’alias soit validé, il est nécessaire d’enrôler la carte American Express au dispositif Amex SmartBill.
Voici le détail de la procédure d’enrôlement d’une carte American Express :
1. Enregistrement des données carte American Express par web de paiement, webservices createWallet, TPVE ou fichier
2. American Express communique un compte rendu de traitement qui confirme l’éligibilité des cartes sous 24h à Monext Online.
3. Monext Online peut vous notifier par email ou par serveur du résultat de l’enrôlement
4. Vous pouvez venir chercher le résultat de l’enrôlement :
a. Sur le centre d’administration Monext Online
b. Par le web service getWallet.
Monext Online vous propose des pages web qui permettent d’enregistrer une carte dans un portefeuille virtuel Monext Online.
Lors de l’appel à cette page, vous devez préciser l’alias qu’il souhaite utiliser (champ walletID) et Monext Online se charge de faire le lien entre cet alias et la carte qui sera débitée chez American Express (cf. L’alias Amex).
Ces pages sont entièrement personnalisables : charte graphique + URL ; et s’intègrent ainsi parfaitement dans le tunnel d’achat d’une boutique en ligne.
Pour accéder à ces pages de paiement, vous avez à votre disposition deux web services : createWallet et ManageWebWallet.
Lors de création du portefeuille via les pages web de paiement une demande d’autorisation à 1 euro est effectuée. Cette autorisation permet de valider que la carte n’est pas en opposition et qu’elle est bien adossée à un compte American Express.
Monext Online vous propose une API webservice SOAP qui permet d’enregistrer et mettre à jour une carte dans un portefeuille virtuel Monext Online. Dans ce cas, vous devez préalablement collectées les données cartes.
La fonction createWallet permet l’enregistrement d’une carte dans un portefeuille virtuel Monext Online. Lors de l’appel à cette fonction, vous devez préciser l’alias à utiliser (champ walletID) et Monext Online se charge de faire le lien entre cet alias et la carte qui sera débité chez American Express (cf. L’alias Amex).
Monext Online vous propose une application web conçu pour des téléconseillers et opérateurs backoffice. Elle permet d’enregistrer une carte dans un portefeuille virtuel Monext Online et d’encaisser ou rembourser des paiements.
Cette application est accessible via l’adresse internet https://homologation-tpv.payline.com.
L’opérateur doit renseigner les données carte Amex dans un second écran. Ces données sont enregistrées dans un portefeuille virtuel Monext Online. L’identifiant du portefeuille (walletID) est la référence client renseignée dans l’écran.
Enrôlement d’une carte AMEX par fichier
Vous pouvez réaliser la création de portefeuille depuis notre fonctionnalité nommée « Interface batch ». Pour cela, vous devez nous transmettre par un flux sécurisé CFT ou FTPS un fichier contenant 1 à N demande de création de portefeuille via la méthode createWallet.
Le format du fichier attendu est décrit dans la spécification PAYLINE-Description_batch interface.
Vous pouvez réaliser vos demandes de paiement AMEX Recurring par Monext Online :
Vous pouvez suivre vos paiements sur Monext Online :
Par reporting transmis de manière automatique quotidiennement ou générés depuis le centre d’administration.
Voici le détail d’un exemple de procédure de paiement d’une carte American Express :
1. Le Commerçant transmets à Monext Online un fichier contenant ses paiements avant 17h pour une prise en compte le jour même par American Express.
2. Monext Online fournit un fichier compte-rendu consécutivement
3. Monext Online transmet à American Express les demandes de paiements et récupère les validations
4. Le commerçant consulte le détail des transactions réalisées :
a. Sur le centre d’administration Monext Online
b. Par reporting
Quand la carte d’un porteur est mise à jour pour les motifs suivants :
American Express informe Monext Online de ces modifications par fichier.
Monext Online enregistre un statut de la carte propre à chaque mise à jour réalisée par AMEX.
Lors de la création d’un portefeuille, avant confirmation de l’enrôlement par AMEX, le portefeuille est actif et la valeur par défaut du statut est égale à « WR » correspondant à « Waiting Enrolment Result ».
Lors des mises à jour réalisées par AMEX (confirmation d’enrôlement, refus d’enrôlment, carte résiliée par exemple), la valeur de ce statut évolue et peut prendre une valeur décrite dans le tableau ci-dessous :
Statut des cartes | Description / Valeur de l’acronyme |
---|---|
EDU | Expiration Date Updated / Date d’expiration mise à jour |
PU | Product Updated /Produit mis à jour |
CC | Card Cancelled / Carte Résiliée |
EA | Enrollement Accepted / Enrôlement accepté par AMEX |
ER | Enrollement Refused/ Enrôlement refusé par AMEX |
WR | Wainting Enrolment Result / En attente de la réponse de AMEX |
Pour consulter l’évolution de vos cartes clients, nous vous conseillons de configurer les notifications serveurs et/ou email pour être alerté du changement d’état des cartes.
Suite à ces notifications, vous pouvez consulter sur le centre d’administration Monext Online et par Web services l’état d’une carte AMEX.
Vous pouvez configurer l’envoi d’un email ou/et d’une notification serveur sur le centre d’administration Monext Online pour être alerté du changement de statut d’une carte dans ces deux cas :
Pour réaliser cette configuration, vous devez vous connecter au centre d’administration Monext Online, puis rendez-vous dans le menu « Configuration > Vos points de vente > Edition d’un point de vente ». Sur cet écran, vous pouvez cocher deux options correspondantes à ces deux types de notifications :
Vous pouvez choisir d’être notifié dans les cas suivants :
Cas | Notification mail | Notification serveur |
---|---|---|
Résultat de l’enrôlement d’une carte Amex SmartBill . | ||
Désactivation d’une carte à cause d’une résiliation. | ||
Expiration d’une carte dans un portefeuille | ||
Création d’un portefeuille |
Consulter le statut de votre carte
Si vous choisissez d’être alerté par email, vous recevrez un email résultat d’enrôlement sur ce modèle :
Version Française | Version Anglaise | |
---|---|---|
Sujet | Résultat d’enrôlement SmartBill | SmartBill enrollement result |
Message dans le cas d’un enrôlement accepté | Bonjour L’enrôlement de votre portefeuille Smartbill suivant a été validé par American Express N° portefeuille: <external_wallet_id>. Cordialement | Hello, The enrollment of your following portfolio “Smartbill” was validated by American Express N° portfolio: <external_wallet_id>. Regards |
Message dans le cas d’un enrôlement refusé | Bonjour, L’enrôlement de votre portefeuille Smartbill suivant a été refusé par American Express N° portefeuille: <alias du portefeuille >. Code de refus : <code_refus> Message de refus : <description_refus> Ce portefeuille ainsi que ses dossiers de paiement et ses échéances ont été désactivés. Cordialement | Hello, The enrollment of your following portfolio “Smartbill” was refused by American Express : N° portfolio: < alias du portefeuille >. Return code : < code_refus > Message de refus : <description_refus > This portfolio and its payment records and billing records were disabled Regards |
En cas d’échec d’enrôlement, les champs :
seront remplies par des codes et description AMEX fournis en annexe de cette documentation.
Voici les paramètres de la notification que vous recevrez pour vous informer du résultat de l’enrôlement d’une carte :
Paramètre | Valeur |
---|---|
notificationType | Wallet |
walletId | EXTERNAL_WALLET_ID |
type | smartbillEnrollResult |
result | Y (si l’enrôlement est accepté) N (si l’enrôlement est refusé) |
resultCode | code retour de l’enrôlement |
Voici les paramètres de la notification que vous recevrez pour vous informer de la résiliation d’une carte :
Paramètre | Valeur |
---|---|
notificationType | Wallet |
walletId | EXTERNAL_WALLET_ID |
type | smartBillCanceledCard |
CancellationCode | motif de la résiliation |
Vous pouvez consulter, dans le détail d’une transaction, depuis le centre d’administration Monext Online, le résultat précis de chacune de vos transactions. Dans le cas d’un enrôlement, vous pouvez consulter le détail de la transaction d’un euro.
L’encart « Historique des statuts » pourra prendre une valeur de la liste fournie en annexe de cette documentation pour préciser les raisons d’un refus d’enrôlement.
Dans les autres cas de transactions, les codes retours consultés seront ceux des codes retours AMEX standards.
Vous pouvez consulter l’ensemble de vos transactions quotidiennement dans les reporting suivants :
Chacun de ces fichiers peut être transmis de manière automatisée par transfert sécurisé CFT ou FTPS.