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

Avec l'API Web Payment de Payline, vous pouvez intégrer le mode Shortcut : 

Les web services en mode Web

Le mode d'intégration est disponible avec l'API WebPayment  : services doWebPayment et getWebPaymentDetails. 

• Interfaces de paiement : API WebPayment, Cente d'administration, TPEV, Batch.

• Paiement à la commande : en utilisant le service  doWebPayment  avec payment.mode à CPT et code Action à 101.

• Paiement à l'expédition : en utilisant les services doWebPayment  et doCapture avec le code Mode à CPT et code Action à 100.

• Demande d'annulation d'une autorisation non encaissée : utilisez la fonction doReset permet au marchand de demander l’annulation totale ou partielle de la commande.

• Demande de remboursement d'une transaction remisée : utilisez la fonction doRefund pour rembourser la commande.
• Mode de paiement : comptant, différé, récurrent, n fois  avec le code Mode = CPT.
• Module fraude : règles sur la transaction, l'acheteur et sur le moyen de paiement.
• 3DSV2 : Suivre l'intégration des pages web : 3DSV2 avec Interface PageWeb.

Rediriger l'acheteur après l'authentification sur Amazon Pay

L'acheteur revient sur la page où se trouvait le widget au départ.

Pour rediriger l'acheteur sur la page de votre choix après son authentification chez Amazon, vous devez alimenter le paramètre ‘data-partnerreturnurl’ en mode Widget, en ajoutant cet attribut dans la balise <div> avec le token session. 

function _getURLParameterFromHash(name, source) {
    return decodeURIComponent((new RegExp('[?|&|#]' + name + '=' +
        '([^&]+?)(&|#|;|$)').exec(source) || [, ""])[1].replace(/\+/g,
        '%20')) || null;
}

var state = _getURLParameterFromHash('state', location.hash);
if (state != null) {
    var split = state.split('&');
    if (split != null) {
        for (var i = 0; i < split.length; i++) {
            const param = split[i];
            if (param.indexOf('token') !== -1 || param.indexOf('payline-token') !== -1) {
                var splittedParam = param.split("=");
                urlToken = splittedParam[1];
            }
        }
        if (urlToken) {
            element.setAttribute('data-token', urlToken);
        }
    }
}

Récupérer l'adresse de livraison

 Il est indispensable pour le commerçant de récupérer l'adresse de livraison via les fonctions de l'API widget Payline pour assurer l'envoi à la bonne adresse et afin d'obtenir la garantie de paiement Amazon Pay : voir le processus de paiement developer.amazon.com.fr.

Mode Widget 

• surcharger le bouton Payer en créant un bouton Continuer : InitShortcut() ;
• récupérer l'adresse via la fonction getBuyerShortcut() ;
• proposer de sélectionner le mode de livraison en fonction de l'adresse ;
• mettre à jour l'adresse utilisée avec updateWebpaymentData() et finalizeShortcut() puis proposer le bouton Payer ;
• afficher le résultat du paiement.

Mode Shortcut

• sur le bouton Payer prévoir un callback widget Payline ; 
• le commerçant récupère l'adresse de livraison via les fontion du widget Amazon pour déterminer les modes de livraison disponibles ;
• sur le bouton Payer géré par le ommerçant, mettre à jour le montant en fonction du mode de livraison ;
• La callback passée déclenchera le clique sur le bouton caché Continuer
• exécuter al fonction iniShortcut(data-shortcutfinalizeauto = TRUE ;
• afficher le résultat du paiement.

En mode Direct

Avec l'API Direct Payment de Payline, vous pouvez intégrer le mode direct  : 

Les fonctionnalités de paiement disponibles :

• Le paiement à la commande en utilisant les services doAuthorization et/ou doCapture ;
• La fonction  getWebPaymentDetail  renvoie l’échéancier sélectionné par l'acheteur.
• 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 : 
  • Vous devez récupérer les informations en post paiement selon la procédure décrite par Amazon Pay : 
    Consulter la procédure AmazonPay : https://developer.amazon.com/fr/docs/eu/amazon-pay-onetime/sca-upgrade.html

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

Avec l'API WebPayment, Payline vous informe du résultat d'un paiement via le ShortMessage des services getWebPaymentDetails.
Avec l'API DirectPayment, Payline vous informe du résultat de manière synchrone en réponse du service getTransactionDetails.
Lorsque le paiement est accepté, Payline renvoie le ShortMessage = ACCEPTED.
Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 04xxx pour une suspicion de fraude).

Les codes spécifiques au moyen de paiement sont listés ici.

Les codes les plus utilisés sont :

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