Contenu

Sommaire

maxLevel	2
style	none

Qu'est-ce que AmazonPay ?

AmazonPay est un moyen de paiement qui permet aux consommateurs de payer en ligne sans communiquer leurs données bancaires, simplement en s'identifiant avec login et un mot de passe.
Amazon permet une intégration Shortcut : le consommateur n'a plus besoin de s'authentifier ou de créer un compte sur le site marchand. AmazonPay transmet les informations, les adresses de livraison et facturation au site marchand.

Le consommateur aura déjà créé son compte AmazonPay avec son carnet d'adresses et porte-monnaie électronique.
Les transactions sont garanties si le marchand respecte les prérequis AmazonPay.
Le marchand doit ouvrir un compte AmazonPay.

Lien vers le site web : https://pay.amazon.com/fr?ld=SEFRAPAExtension1

Les fonctions disponibles

En synthèse :

le consommateur est informé directement du résultat de son paiement par l’affichage du ticket de paiement sur une page Payline ou commerçant ;
la fonction de paiement « Autorisation + Validation » est possible ;
les fonctions de remboursement et d'annulation sont disponibles ;
le moyen de paiement est multidevise ;
le moyen de paiement est compatible avec l'authentification 3DS v2 ;
la fonction SoftDescriptor est disponible ;
- seuls les caractères suivants sont autorisés: '0-9', 'a-z', 'A-Z', '', '+' , ',', '-', '.' ;
- les banques acceptent 16 caractères.

Vous devez obtenir un contrat directement auprès de AmazonPay.

Ce moyen de paiement est disponible avec l'API WebPayment : mode Widget et ShortcutCheckout.

Quel est le parcours utilisateur avec AmazonPay ?

L'expérience utilisateur d'un paiement se résume aux étapes suivantes :

Le consommateur valide sa commande en cliquant sur le bouton AmazonPay ;
Le consommateur confirme le paiement en authentifiant avec son compte et mot de passe ;
Le consommateur valide ses adresses et son moyen de paiement de son compte AmazonPay ;
Le marchand valide la commande.

Exemple de captures d'écran du parcours de paiement AmazonPay :

Diagramme draw.io

diagramName	Parcours AmazonPay
width	1567.5000000000005
zoom	1
lbox	true
contentVer	1
height	571.0000000000002
revision	3

Comment proposer AmazonPay à vos clients ?

Vous pouvez afficher le bouton AmazonPay sur le panier, ou dans la liste des moyens de paiement.

En mode Shortcut

Les étapes

Description

1. Le marchand initie le paiement

Appeler le service doWebPayment avec un contractNumber AmazonPay ;

2. Le marchand affiche le bouton AmazonPay sur le panier en mode Widget

Développer

title	Affichage du widget Payline

Ajouter les scripts suivants dans le head de la page :
<script src=“$environment/scripts/widget-min.js" charset="utf-8"></script>
<link rel="stylesheet" href="$environment/styles/widget-min.css" charset="utf-8">

Ajouter le code suivant dans le body de la page :

Si vous masquez les moyens de paiement du compte Amazon:

.pl-amazon-wallet-container { display : none; }

Les URL de retour au panier ne doivent pas contenir de paramètres GET.

3. Le marchand affiche le carnet d'adresses et les moyens de paiement d'Amazon

Développer

title	Affichage de la page

Ajouter les scripts suivants dans le head de la page :

Ajouter le code suivant dans le body de la page :

Si vous masquez les moyens de paiement du compte Amazon:

.pl-amazon-wallet-container { display : none; }

4. Le marchand récupère les informations acheteurs et adresses

Utiliser la fonction : Payline.Api.getBuyerShortcut();

5. Le marchand doit récupérer les informations mises à jour si le consommateur change son adresse de livraison ou de facturation ou son moyen de paiement

Développer

title	Utiliser le callback du Widget Payline

Lorsque le consommateur change d’adresse, vous êtes prévenu via la callback widgetStateCallback et l’état PAYMENT_TRANSITIONAL_SHORTCUT. Il suffit alors de faire un nouvel appel à Payline.Api.getBuyerShortcut()

A la validation du mode de livraison (clic sur le bouton Poursuivre) : mettre à jour les informations de livraison, de facturation et le montant de la commande Payline.Api.updateWebpaymentData();

6. Le marchand valide le paiement (clic sur le bouton payer)

Appeler la fonction Payline.Api.finalizeShortCut();

7. Le marchand doit contrôler le résultat du paiement

Utiliser le getWebPaymentDetails pour contrôler le montant, adresses et mode de livraison et les informations du consommateurs.

En mode Direct

Les fonctionnalités de paiement disponibles :

Le paiement à la commande en utilisant le service doAuthorization ;
La demande de remboursement partiel et multiple d'une transaction remisée avec le service doRefund.

Les spécificités AmazonPay :

Le nom et prénom sont regroupés dans la balise buyer.lastname ;
Le service doCapture et doRefund répondent un code retour ON_HOLD_PARNER. Une notification sera envoyée vers le marchand dès la mise à jour ;
Adresse de livraison :
- Une adresse de livraison est rattachée à un ou plusieurs moyens de paiement. Un moyen de paiement est rattaché à une adresse de facturation.
- Pour les cas où le commerçant souhaite garder son adresse de livraison au lieu de l'adresse de livraison du consommation d'Amazon, il suffit de réaliser un appel de la fonction Payline.Api.updateWebPaymentData() avant l'appel à Payline.Api.finalizeShortCut(). Par exemple si l'adresse de livraison n'est pas l'adresse domicile du consommateur : point relais, adresse du magasin...
Référence commande :
- De la même manière avec la fonction Payline.Api.updateWebPaymentData vous pouvez mettre a jour la référence commande à la fin du parcours si la référence commande n'est pas définie en début de parcours.
Authentification forte :
- Consulter la procédure AmazonPay : https://developer.amazon.com/fr/docs/eu/amazon-pay-onetime/sca-upgrade.html

Dans les prochains lot, Payline prévoit

Le paiement à l'expédition en utilisant le service doAuthorization ;
La validation partielle et multiple avec le service doCapture ;
La création de demande d'annulation d'une autorisation non encaissée avec le service doReset ;
L'envoi de notification sur le remboursement et la validation ;
La réconciliation avec le fichier des paiements ;
La mise à jour du module Magento ;
L'intégration du module de lutte contre la fraude ;
La création d'autorisation asynchrone (lot 3).

Extrait

Création d'un compte marchand AmazonPay

Pour mettre en place AmazonPay sur Payline, vous devez créer un compte AmazonPay dans SellerCentral et récupérer les informations ID Marchand, Jeton d'autorisation NWS et Identifiant Client nécessaires pour configurer votre contrat Payline.

Pour créer un compte AmazonPay

Cette procédure est présentée à titre indicatif, veuillez vous reporter à la documentation AmazonPay pour tout complément ou changement.

Lancer le script : OnBoardingMonext.html contenant l'id PSP Payline.
Suivre les étapes d'inscription et fournir les informations, coordonnées commerciales et bancaires puis récupérer l'ID Marchand le menu Intégration > Clé d'accès NWS.
Associer le compte marchand avec le compte PSP Payline : dans le lien sellercentral, sélectionner le menu Paramètres > Autorisations utilisateur.
Autoriser un développeur avec le nom Monext et le l'identifiant : 1310-1336-9584, puis récupérer le Jeton d'autorisation MWS. Voir l'identifiant de production.
Inscrire une nouvelle application à l'aide du menu de sellercentral, choisir le menu Connectez-vous avec Amazon et cliquer sur Inscrivez une nouvelle application.
- Vous devez whitelister les URL d'appel à Amazon. Les URL serront statiques.
- Pour le shortcut, vous devez indiquer l'URL d'appel depuis le bouton Amazon Pay ;
- Pour le mode à redirection (page web de paiement V2 de Payline), vous devez supprimer le token de l’URL et whitelister URL avec le template dans l’interface Seller Central à chaque modification du template (voir l'encart information pour plus de détail).
Déployer l'encart Paramètres Web et récupérer l'Identifiant client.
Remplir impérativement les champs indiqués comme facultatifs. Les paramètres GET ne sont pas autorisés dans les URL de retour au panier :
- Origines JavaScript autorisées: il s'agit des URLs des sites du commerçant ;
- URL de renvoi autorisées: il s'agit des URL de retour au panier.

Info
Veuillez suivre la procédure détaillée sur ce lien.

Pour créer un moyen de paiement dans le centre

d'

administration

PAYLINE

Payline

Vous devez vous rapprocher de votre responsable de compte partenaire pour obtenir les informations nécessaires permettant de configurer votre compte de production sur Payline (contrat vad, ID marchand, Jeton d'authorisation MWS, Identifiant client).

Ensuite veuillez adresser un email à notre équipe support@payline.com avec les informations ci dessous, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer. Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.

Ce numéro de contrat (alias) vous permettra d'effectuer les paiements.

Développer

title	Liste des paramètres du compte Payline

Paramètre Payline

Description

ID commerçant

ID marchand récupéré précédemment sur sellercentral

ID de l'application

Identifiant client de l'application du marchand récupéré précédemment sur sellercentral

Token MWS

Jeton d'authorisation MWS associé au compte Monext récupéré précédemment sur sellercentral

Type de buton

Aspect souhaité pour le bouton Amazon Pay

Couleur du bouton

Valeurs possibles : Gold (par défaut), LightGray, DarkGray

Taille du bouton

Valeurs possibles : small, medium (valeur par défaut), large, x-large

Liste blanche des pays de livraison

Cette liste est utilisée pour contrôler l'adresse de livraison.

(vide) : Aucun contrôle sur l'adresse de livraison

État

colour	Yellow
title	LOT 2

codes pays suivants normes ISO 3166 séparés par des ";" (Ex.: "FR;IT;ES") → PAYLINE contrôle l'adresse de livraison. Si elle est dans un pays hors liste blanche alors un message d'erreur demande à l'acheteur de changer son adresse de livraison.

Région

Il s'agit de la région Amazon de laquelle dépend le compte marchand

UK → Grande Bretagne
État
colour Yellow
title LOT 2
DE → Europe (valeur par défaut)
US → Etats Unis
État
colour Yellow
title LOT 2
JP → Japon
État
colour Yellow
title LOT 2

Astuce

title	Consignes AmazonPay sur les boutons

https://pay.amazon.com/fr/merchant/tools

Développer

title	Dans la section Information compte Amazon Pay, indiquer les champs spécifiques suivant

Type du bouton

LwA
Login
PwA (valeur par défaut)
Pay
A

Taille du bouton

small

medium (valeur par défaut)

large

x-large

Couleur du bouton

Gold (valeur par défaut)
LightGray
DarkGray

Validez votre intégration

Cette étape obligatoire vous permet de contrôler que votre intégration est correcte.

Obtenez une transaction de paiement accordée avec le numéro de contrat Amazon Payline.
Consultez le centre d'administration commerçant et validez le bon enregistrement de vos transactions de paiement.

Quel est le reporting disponible ?

Les transactions AmazonPay apparaissent dans le centre administration Payline en temps réel et dans les fichiers de reporting suivants :

fichier des transactions ;
fichier des paiements avec l'option réconciliation.

Développer

title	Type d'opération

Type d'opération chez AmazonPay	Opération dans Payline	Description
Authorisation	CAP	Demande d'encaissement ou de remboursement
Capture	SET type C	Encaissement
Refund	SET type D	Remboursement
Chargeback	CBK	Impayé

Comment réaliser des tests ?

Toutes les types de cartes acceptées dans le wallet AmazonPay seront acceptés pour un paiement, consulter la documentation d'AmazonPay pour tout complément information.

Note : Il est indispensable de réaliser des tests transactionnels sur l'environnement de production avec des comptes Amazon après la validation de la mise en œuvre sur l'environnement de test.

Les codes de retour

Payline vous informe du résultat de manière synchrone en réponse du doAuthorization.
Lorsque le paiement est accepté, Payline renvoie le code retour à la valeur « 00000 ».
Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 02xxx pour une suspicion de fraude).

Les codes les plus utilisés sont :

Code Payline	ShortMessage	LongMessage
00000	ACCEPTED	Operation Successfull
02000	ONHOLD_PARTNER	Transaction in progress, please wait for payment status
02008	CANCELLED	Transaction canceled by user => redirection sur abort ou timeout url
02016	ONHOLD_PARTNER	Transaction hold on partner, please wait for payment method return
02008	CANCELLED	Transaction canceled by user
02020	REFUSED	Transaction refused by partner
02101	ERROR	System internal error (frontend)
02102	ERROR	Acquirer server communication error
02324	REFUSED	The session expired before the consumer has finished the transaction
02106	ERROR	Payment partner error
02012	ERROR	Unmatched partner return code
02305	ERROR	Invalid field format
02308	ERROR	Invalid value for
02310	ERROR	Requested function not available

Les liens web

Voici les liens utiles :

Garantie Amazon de A-à-Z pour les marchands : https://pay.amazon.com/fr/help/201212410
Garantie Amazon de A-à-Z pour les acheteurs : https://pay.amazon.com/fr/help/201751470
Opposition FAQ : https://pay.amazon.com/fr/help/201749690
Chargeback best practices : https://pay.amazon.com/fr/help/201749670

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 = "wallet" and label = "presentation" and type = "page" and space = "DT"
labels	bancontact belgique choixdelamarque

Arborescence des pages

Comparaison des versions

Ancienne version 24

Nouvelle version 25

Légende

Qu'est-ce que AmazonPay ?

Les fonctions disponibles

Quel est le parcours utilisateur avec AmazonPay ?