Fonction init
Cette fonction init crée et initialise l’instance de Requête Paysafe. Les options de Requête Paysafe sont alors validées et une requête asynchrone est envoyée au serveur dorsal pour obtenir les informations sur le marchand correspondant à la clé API. Il s’agit de la première étape d’exécution de votre script. Après avoir appelé cette fonction, mais avant que l’utilisateur ne clique sur le bouton de paiement, la fonction updateOptions peut être utilisée pour modifier tous les paramètres d’option, sauf l’environnement.
La signature de la fonction est la suivante :
paysafe.request.init(apikey,options);
Les paramètres de la fonction sont décrits ci-dessous.
| Paramètre | Requis | Type | Description |
|---|---|---|---|
| apiKey | true | string | La version encodée en Base64 de la clé API générant un jeton à usage unique utilisée pour l’authentification avec l’API REST Coffre-fort client. Cette clé ne peut être utilisée que pour générer des jetons à usage unique à utiliser avec l’API Paiements par carte. Elle ne peut pas être utilisée pour effectuer des paiements et peut donc être exposée publiquement dans le navigateur de l’utilisateur. |
| options | true | object | Paramètres à appliquer à Requête Paysafe, comme l’environnement à utiliser (Test ou Live), le montant du paiement, la devise, le pays et les paramètres permettant de personnaliser le formulaire de paiement et de fournir des adresses. |
| {throws} | s.o. | Déclenche une exception avec les erreurs suivantes : 9013, 9014, 9015, 9017, 9055, 9054, 9066, 9068, 9069, 9070, 9071. | |
| {return} | false | undefined |
Paramètres d’option init
Il s’agit des paramètres de l’optioninit.
| Paramètre des options | Requis | Type | Description |
| montant | true | number | Montant du paiement en unités mineures à débiter de la carte du client. Utilisez le montant correct des unités mineures pour la devise du compte marchand. Par exemple, pour traiter 10,99 $ US, cette valeur doit être 1099. Pour traiter 1000 yens japonais, cette valeur doit être 1000. Pour traiter 10 139 dinars tunisiens, cette valeur doit être 10139. Le montant du paiement doit être fourni sous la forme d’un nombre positif et ne doit pas comporter plus de 9 chiffres. |
| country | true | string | Le code de pays à deux caractères en exposant ISO 3166. |
| devise | true | string | Code à trois caractères pour la devise de paiement; p. ex. USD pour dollars américains |
| environment | false | string | Environnement auquel Requête Paysafe est connectée :
Si vous omettez l’objet environment, en transmettant une valeur vide ou nulle pour ce paramètre, l’environnement Live sera utilisé. Vous ne pouvez pas modifier ce paramètre à l’aide de la fonction updateOptions. N’utilisez pas de numéros de cartes réels ou d’autres données relatives à des instruments de paiement dans l’environnement de test marchand, car il n’est pas conforme aux normes de sécurité des données de l’industrie des cartes de paiement (PCI-DSS) et ne protège pas les informations relatives au titulaire de la carte ou au bénéficiaire du paiement. Tout téléchargement de données réelles de titulaires de cartes est strictement interdit, comme décrit dans les conditions d’utilisation.. |
| label | true (Apple Pay uniquement) | string | Étiquette affichée immédiatement après le bouton « Payer » dans la page de paiement Apple Pay. |
| requestBillingAddress | false | boolean | Définir sur true pour inclure les informations de facturation dans la fonction onTokenization de la réponse au rappel contenant le jeton. La valeur par défaut est false. |
| requestShippingAddress | false | boolean | Définir sur true pour inclure les informations de livraison dans la fonction onTokenization de la réponse au rappel contenant le jeton. La valeur par défaut est false. |
| supportedNetworks | false | tableau de chaînes | Les réseaux de paiement que vous prenez en charge. Valeurs éventuelles (non sensibles à la casse) :
|
applePay: supportedCountries | false | tableau de codes de pays à deux lettres de l'ISO 3166 | Limite les paiements aux cartes de certains pays. |
Exemple Apple Pay
Cet exemple dans l’environnement TEST montre comment spécifier l’initialisation d’une instance de Requête Paysafe. Ne comprend pas showButtons 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>
paysafe.request.init("my API key", {
country: "US",
currency: "USD",
amount: 1234,
label: "My label",
supportedNetworks: ["VISA", "MASTERCARD"],
environment: "TEST",
applePay: {
supportedCountries: ["US", "CA"]
}
});
</script>
</body>
</html>