Contenu
Sommaire | ||||
---|---|---|---|---|
|
Plus d'informations
Qu'est-ce que la carte Amex Recurring ?
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.
Fonctions monétiques disponibles
Les Web Services que vous pourrez utiliser :
- la gestion des portefeuilles virtuels,
- le paiement récurrent,
- La fonction soft descriptor.
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 :
- Wallet : retour d'enrollement AMEX ou mise à jour wallet
- BILL : retour du résultat du paiement
La cinématique de paiement
Étape 1 : L’enrôlement de la carte American Express
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 :
- Par page Web de paiement
- Par Web Services
- Par le TPEV
- Par fichier
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.
L’alias AMEX
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.
Détail de la procédure d’enrôlement
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.
Enrôlement d’une carte AMEX depuis les pages de paiement
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.
Enrôlement d’une carte AMEX par Web Service
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).
Enrôlement d’une carte AMEX par le TPEV
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.
Étape 2 : Réaliser vos paiements avec Amex Recurring
Vous pouvez réaliser vos demandes de paiement AMEX Recurring par Monext Online :
- Par fichier : vous pouvez nous transmettre vos demandes de paiements en précisant l’alias et le montant à débiter selon un format de fichier défini dans la spécification « PAYLINE-Description_batch interface-FR-v1.D.pdf »
- Par web services : vous pouvez appeler les web services doImmediateWalletpayment et doScheduledWalletPayment pour réaliser des paiements immédiats ou programmés.
Vous pouvez suivre vos paiements sur Monext Online :
- Par le centre d’administration : le détail de chaque transaction est consultable sur les 11 derniers mois.
Par reporting transmis de manière automatique quotidiennement ou générés depuis le centre d’administration.
Détail de la procédure de paiement
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
Étape 3 : Suivre les mises à jour de vos cartes
Quand la carte d’un porteur est mise à jour pour les motifs suivants :
- Nouvelle date d’expiration
- Nouveau produit
- Résiliation d’une carte
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.
Liste des statuts cartes 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 |
Consulter l'évolution de vos cartes clients
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.
Notification email et serveur
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 :
- Résultat de l’enrôlement accepté ou refusé
- Résiliation d’une carte
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 :
- Configuration pour recevoir une notification par email
- Configuration pour recevoir une notification serveur
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
- Sur le centre d’administration : Depuis le centre d’administration, vous pouvez consulter le statut d’une carte à partir du menu « Paiement récurrent > Gestion des portefeuilles > Edition d’un portefeuille »
- Dans nos Web Services : Vous pouvez réaliser un appel au web service « getWallet » pour consulter le statut d’une carte dans le champ « card_status ».
Mail résultat d’enrôlement
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 :
- <code_refus>
- <description_refus>
seront remplies par des codes et description AMEX fournis en annexe de cette documentation.
Notification serveur résultat d’enrôlement
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 |
Notification serveur carte résiliée
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 |
Suivre vos paiements AMEX Recurring
Suivi des transactions depuis le back office
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.
Fichiers reporting
Vous pouvez consulter l’ensemble de vos transactions quotidiennement dans les reporting suivants :
- Fichier « Suivi des transactions »
- Fichier des paiements
Chacun de ces fichiers peut être transmis de manière automatisée par transfert sécurisé CFT ou FTPS.
Pages associées
Contenu par étiquette showLabels false max 10 spaces com.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@9a3 showSpace false sort title type page cql label = "presentation" and label = "credit" and type = "page" and space = "DT" labels bancontact belgique choixdelamarque