Fonctions supplémentaires
Cette section présente les fonctions supplémentaires disponibles dans la SDK Paysafe.js.
Fonctions de champ supplémentaires
Ces fonctions renvoient des informations sur un champ spécifié à l’aide des valeurs membres suivantes :
- cardNumber
- cvv
- expiryDate
- expiryMonth
- expiryYear
Cette valeur est sensible à la casse
isEmpty
Vérifie si le client a saisi une valeur dans le champ sélectionné.
Renvoie « true » si le champ est vide.
Exemple d’utilisation :
var isEmpty = instance.fields.cvv.isEmpty();
isValid
Vérifie si le client a saisi une valeur valide dans le champ sélectionné.
Renvoie « true » si le champ contient des valeurs valides.
Exemple d’utilisation :
var isValid = instance.fields.cvv.isValid();
Inscription abrégée à un événement
L’inscription abrégée à un événement vous permet de vous inscrire à un événement à partir d’un seul champ ou d’une liste de champs séparés par des espaces.
La signature de cette fonction est la suivante :
instance.fields.<fieldname>.<event type>(function(instance, event) {
...
})
Remplacez <fieldname> par une seule valeur de la liste ci-dessous :
- cardNumber
- cvv
- expiryDate
- expiryMonth
- expiryYear
Cette valeur est sensible à la casse.
Remplacez <event type> par l’un des types d’événements suivants :
- focus
- blur
- valid
- invalid
- fieldValueChange
- invalidCharacter
Cette valeur est sensible à la casse
Exemple d’utilisation :
<html>
...
<body>
...
<script>
paysafe.fields.setup("my Base64 encoded single-use-token API key", function(instance, error) {
if (error) {
console.log(error);
} else {
instance.fields.cvv.focus(function(instance, event) {
this.style.borderColor = "green";
});
}
});
</script>
</body>
</html>
Il existe une autre syntaxe abrégée utilisant la fonction suivante :
instance.fields(fieldname).<event type>(function(instance, event) {
...
})
fieldname est une chaîne représentant le ou les champs à partir desquels il faut s’inscrire à un événement. Vous pouvez également spécifier plusieurs champs séparés par des espaces pour vous inscrire à un événement à partir de tous les champs répertoriés.
Cette valeur n’est pas sensible à la casse.
Exemple d’utilisation :
<html>
...
<body>
...
<script>
paysafe.fields.setup("my Base64 encoded single-use-token API key", function(instance, error) {
if (error) {
console.log(error);
} else {
instance.fields("cvv cardNumber expiryDate").focus(function(instance, event) {
this.style.borderColor = "green";
}).blur(function(instance, event) {
this.style.borderColor = "initial";
});
}
});
</script>
</body>
</html>
Méthodes d’instance supplémentaires
areAllFieldsValid
Renvoie « true » si tous les champs de l’instance sont valides.
Exemple d’utilisation :
var isTokenizationAvailable = instance.areAllFieldsValid();
if (!isTokenizationAvailable)
{
alert("Enter your card information before you can pay");
}
else
{
instance.tokenize(function(instance, error, result) {
console.log(result.token);
});
}
Soumettre
Fournit une inscription abrégée à l’événement Soumettre. Cette méthode a la signature suivante :
instance.submit(function(instance, event) {
...
})
Exemple d’utilisation :
<html>
...
<body>
<div id="cardNumber" paysafe="card-number"></div>
<div id="cvv" paysafe="cvv"></div>
<div id="expiryDate" paysafe="expiry-date"></div>
<script>
paysafe.fields.setup("my Base64 encoded single-use-token API key", function(instance, error) {
if (error) {
console.log(error);
} else {
instance.cardBrandRecognition(function(instance, event) {
document.getElementById("cardNumber").style.borderColor = event.data.cardBrand ? "green" : "initial";
});
}
});
</script>
</body>
</html>
CardBrandRecognition
Fournit une inscription abrégée à l’événement cardBrandRecognition. Cette méthode a la signature suivante :
instance.cardBrandRecognition(function(instance, event) {
...
})
Exemple d’utilisation :
<html>
...
<body>
<div id="cardNumber" paysafe="card-number"></div>
<div id="cvv" paysafe="cvv"></div>
<div id="expiryDate" paysafe="expiry-date"></div>
<script>
paysafe.fields.setup("my Base64 encoded single-use-token API key", function(instance, error) {
if (error) {
console.log(error);
} else {
instance.cardBrandRecognition(function(instance, event) {
document.getElementById("cardNumber").style.borderColor = event.data.cardBrand ? "green" : "initial";
});
}
});
</script>
</body>
</html>
getCardBrand
Cette fonction détermine la marque de la carte actuelle à partir du numéro de carte saisi par le client, ou renvoie une valeur non définie si aucune marque n’est reconnue.
Exemple d’utilisation :
var cardBrand = instance.getCardBrand();
switch (cardBrand) {
case "American Express":
...
break;
case "MasterCard":
...
break;
case "Visa":
...
break;
case "Diners Club":
...
break;
case "JCB":
...
break;
case "Maestro":
...
break;
}