Fonction showButtons
La fonction showButtons charge le bouton de paiement pour un mode de paiement spécifique dans votre page en fonction d’un ensemble d’options de bouton de paiement. Vous devez appeler la fonction init avant d’appeler showButtons. En interne, showButtons exécute d’abord la fonction canMakePayment, pour vérifier que le paiement est possible avec l’appareil utilisé pour effectuer l’achat. Ensuite, lorsque le bouton de paiement est sélectionné, la session de paiement (p. ex. Apple Pay) est créée, le marchand est validé et, si tout est conforme, la fiche de paiement s’affiche.
La fonction peut être appelée avec ou sans définition des options du bouton, et a les signatures ci-dessous :
paysafe.request.showButtons(callback) // Utiliser les options de bouton par défaut
paysafe.request.showButtons(buttonOptions, callback) // Utiliser les options de bouton explicites
Les paramètres de la fonction sont décrits ci-dessous.
| Requis | Type | Description | ||
|---|---|---|---|---|
| buttonOptions | false | ensemble d’objets | Options pour la création et l’affichage du bouton de paiement. En cas d’omission, les arguments par défaut suivants sont utilisés :
| |
| paymentMethod | true | string | Le mode de paiement : APPLEPAY | |
| selector | true | string | Identifiant ou élément HTML remplacé par un bouton | |
| color | false | string | La couleur du bouton. Choisir parmi :
| |
| type | false | string | Le type de bouton. Choisir parmi les options suivantes :
| |
| supportedNetworks | false | tableau de chaînes | Spécifie les marques de cartes acceptées. Les valeurs éventuelles sont :
Ceci est sensible à la casse. | |
| callback | true | function(displayedPaymentMethods, error) {...} Le rappel onTokenization doit être défini avant d’appeler showButtons, sinon ce rappel renverra une erreur. | ||
| displayedPaymentMethods | false | tableau de chaînes | Répertorie tous les modes de paiement affichés sur le site du marchand. | |
| error | s.o. | object | Objet de l’erreur indiquant la raison de l’échec : 9001, 9003, 9013, 9015, 9023, 9063, 9065, 9077, 9080, 9084, 9085, 9086, 9087, 9088, 9091, 9092 | |
| {throws} | Déclenche une exception avec les erreurs suivantes : 9004, 9014, 9067. | |||
| {return} | false | undefined | ||
Exemple Apple Pay
Cet exemple dans l’environnement TEST montre comment spécifier l’apparence du bouton de paiement. Ne comprend pas init ni le code onTokenization.
<html>
<head>
<script type="text/javascript" src="https://hosted.paysafe.com/request/v1/latest/paysafe.request.min.js"></script>
</head>
<body>
...
<div id="x-paysafe-apple-pay-button"></div>
...
<script>
...
var appleButtonOptions = {
paymentMethod: "APPLEPAY",
selector: "x-paysafe-apple-pay-button",
color: "white-outline",
type: "buy"
};
paysafe.request.showButtons([appleButtonOptions], function (displayedPaymentMethods, error) {
if (error) {
// handle error
}
});
...
</script>
</body>
</html>
Consultez ce site pour voir les lignes directrices sur l’apparence du bouton Apple Pay.
