La fonction Afficher
La fonction show charge les modes de paiement Paysafe.js dans les conteneurs d’éléments HTML sélectionnés (généralement des éléments div) sur votre page de paiement. Cette fonction ne comporte pas de paramètres.
La fonction doit être invoquée immédiatement après la fonction de configuration de l’instance de champs hébergés, qui est renvoyée lors de la configuration.
La signature de la fonction est la suivante :
instance.show()
.then((paymentMethods) => {
/** Continue with events handling */
if (paymentMethods.card && !paymentMethods.card.error) {
// Card payment method is successfully initialized
}
if (paymentMethods.applePay && !paymentMethods.applePay.error) {
// Apple Pay payment method is successfully initialized
}
})
.catch((error) => {/** Process any errors during the show */})
Vous pouvez également utiliser Aysnc-await :
async function showPaysafeJS() {
TRYtry {
const paymentMethods = await instance.show()
/** Continue with events handling */
if (paymentMethods.card && !paymentMethods.card.error) {
// Card payment method is successfully initialized
}
if (paymentMethods.applePay && !paymentMethods.applePay.error) {
// Apple Pay payment method is successfully initialized
}
} catch(error) {
/** Process any errors during the show */
}
}
Les fonctions d’affichage renvoient une promesse, qui est ensuite résolue dans un objet de modes de paiement.
L’objet paymentMethods contiendra une liste des modes de paiement fournis lors de l’installation et le résultat de leur initialisation.
| Paramètre | Facultatif | Type | Description |
|---|---|---|---|
| paymentMethods | |||
carte | true | object | Un objet qui ne contiendra une erreur que si celle-ci survient lors de l’initialisation du mode de paiement. Lorsque l’initialisation du mode est réussie, un objet vide est renvoyé. |
| applePay | true | object | Un objet qui ne contiendra une erreur que si celle-ci survient lors de l’initialisation du mode de paiement. Lorsque l’initialisation du mode est réussie, un objet vide est renvoyé. |
Afficher l’objet d’erreur
La fonction show() ne génère une erreur que si aucun des modes fournis n’a été initialisé avec succès.
Le tableau suivant décrit le contenu de l’objet « erreur » :
| Paramètre | Requis | Type | Description |
|---|---|---|---|
| code | true | string | Code d’erreur |
| displayMessage | true | string | Message d’erreur à montrer aux clients. |
| detailedMessage | true | string | Une description détaillée de l’erreur (cette information ne doit pas être montrée aux clients). |
| correlationId | true | string | Identifiant d’erreur unique à fournir au service de soutien Paysafe lors de l’enquête. |
Erreurs attendues
| Code | Message affiché | Message détaillé | Description |
|---|---|---|---|
9028 | Une erreur s’est produite (9028); veuillez contacter notre service de soutien. | Échec de l’initialisation des iframes Paysafe.js. | Les iframes utilisés pour les champs de paiement sensibles n’ont pas été initialisés dans les 5 secondes. Cela peut se produire si le serveur qui génère le code HTML pour l’iframe n’est pas disponible. |
| 9073 | Une erreur s’est produite (9073); veuillez contacter notre service de soutien. | Le compte n’est pas configuré correctement. | L’erreur résulte d’une mauvaise configuration du compte marchand :
|
| 9055 | Une erreur s’est produite (9055); veuillez contacter notre service de soutien. | Paramètre de devise non valide. | Le currencyCode n’est pas une devise ISO valide |
| 9084 | Une erreur s’est produite (9084); veuillez contacter notre service de soutien. | Échec du chargement des modes de paiement disponibles. | Il y a eu un problème pour obtenir les modes de paiement du marchand. |
| Erreurs spécifiques à ApplePay | |||
| 9014 | Une erreur s’est produite (9014); veuillez contacter notre service de soutien. | Une erreur non gérée s’est produite. | L’erreur était inattendue, mais elle a été enregistrée et l’identifiant de corrélation a été défini pour faciliter l’examen du problème. |
| 9066 | Une erreur s’est produite (9066); veuillez contacter notre service de soutien. | Paramètre d’étiquette non valide. | Paramètre d’option de l’étiquette de demande de paiement non valide. |
| 9071 | Une erreur s’est produite (9071); veuillez contacter notre service de soutien. | La requête Paysafe est déjà initialisée. | Plusieurs tentatives d’affichage du bouton Apple Pay. |
| 9063 | Une erreur s’est produite (9063); veuillez contacter notre service de soutien. | Paramètre buttonColor non valide. | Utilisé lorsque la couleur fournie n’est pas prise en charge par Apple Pay |
| 9077 | Une erreur s’est produite (9077); veuillez contacter notre service de soutien. | Devise demandée : [XXX] tandis que la devise prise en charge est : [AAA, ...] | Le marchand a demandé une devise via les méthodes init ou update qui n’est pas activée dans son compte (service d’acheminement intelligent). |
| 9085 | Une erreur s’est produite (9085); veuillez contacter notre service de soutien. | Aucun mode de paiement n’est disponible pour cette clé API. | Le marchand n’a pas configuré APPLE PAY. |
| 9086 | Une erreur s’est produite (9086); veuillez contacter notre service de soutien. | Le navigateur ne prend pas en charge les modes de paiement, l’utilisateur n’a pas de carte active dans son portefeuille ou le domaine du marchand n’est pas validé par Apple. | Le navigateur ne prend pas en charge les modes de paiement, l’utilisateur n’a pas de carte active dans son portefeuille ou le domaine du marchand n’est pas validé par Apple. |
| 9088 | Une erreur s’est produite (9088); veuillez contacter notre service de soutien. | Impossible d’afficher les boutons. Demandé : [...], pris en charge : [...] | Les modes de paiement pris en charge et demandés ne concordent pas et le bouton de paiement ne s’affiche pas. |
| 9091 | Une erreur s’est produite (9091); veuillez contacter notre service de soutien. | Paramètre buttonType non valide. | L’argument du type de bouton d’options n’est pas valide. |