Fonction start
La fonction start initialise la procédure de prise d’empreintes digitales d’un appareil pour un client. Elle comporte les paramètres suivants :
- La version encodée en Base64 de la clé d’API publique (générant un jeton à usage unique). Notez que cette clé ne peut être utilisée que pour générer des jetons à usage unique et qu’elle ne dispose d’aucun autre droit d’accès à l’API, comme ceux nécessaires à l’encaissement de paiements. Par conséquent, cette clé peut être exposée publiquement dans le navigateur de l'utilisateur.
- Un objet options contenant l’environnement à utiliser (Test ou Live), l’identifiant du compte et un objet carte contenant le numéro d’identification bancaire (NIB) de la carte qui sera utilisée.
- Une fonction callback pour traiter les erreurs ou informer l’appelant en lui communiquant l’identifiant de l’empreinte digitale de l’appareil.
La signature de la fonction est la suivante :
paysafe.threedsecure.start(apikey,options,callback);
Environnement
L’objet options contient une chaîne permettant de sélectionner l’environnement à utiliser pour l’empreinte digitale de l’appareil, soit LIVE (l’environnement de production Paysafe), soit TEST (l’environnement de test marchand Paysafe ou le bac à sable).
N’utilisez pas de vrais numéros de cartes ou d’autres données d’instruments de paiement dans l’environnement de test marchand. 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 aux titulaires de cartes et aux bénéficiaires. Tout téléversement de données réelles de titulaires de cartes est strictement interdit, comme décrit dans les conditions d’utilisation..
Test
paysafe.threedsecure.start("my Base64 encoded single-use API key", {
environment: "TEST",
accountId: "Preferred account ID",
card: {
cardBin: "The card BIN"
}
}, function (deviceFingerprintingId, error) {...});
Production
paysafe.threedsecure.start("my Base64 encoded single-use API key", {
environment: "LIVE",
accountId: "Preferred account ID",
card: {
cardBin: "The card BIN"
}
}, function (deviceFingerprintingId, error) {...});
Default
Si vous omettez l’objet environment, en passant une valeur vide ou nulle pour ce paramètre, l’environnement Live sera utilisé.
paysafe.threedsecure.start("my Base64 encoded single-use API key", {
accountId: "Preferred account ID",
card: {
cardBin: "The card BIN"
}
}, function (deviceFingerprintingId, error) {...});
Fonction start et ses objets
Voici une liste complète des paramètres de la fonction start, des objets JavaScript utilisés par la fonction start et des paramètres qu’ils contiennent.
| Paramètre | Requis | Type | Description |
|---|---|---|---|
| apiKey | true | string | La version encodée en Base64 de la clé API publique (générant un jeton à usage unique). |
| options | true | object | Il s’agit d’un objet qui contient l’identifiant de compte, l’environnement et un objet carte contenant le numéro d’identification de la banque (NIB). |
| callback | true | function | Il s’agit d’une fonction qui renvoie soit le deviceFingerprintingId ou un code d’erreur. |
| options | |||
| environment | false | string | Ceci permet de sélectionner l’environnement à utiliser pour l’empreinte digitale des appareils. Les valeurs éventuelles sont :
Si aucun environnement n’est spécifié, la valeur par défaut est LIVE. |
| accountId | true | string | Il s’agit de l’identifiant du compte qui sera utilisé pour la transaction. |
| carte | true | object | Cet objet contient le numéro d’identification bancaire de la carte (NIB) requis pour l’opération de prise d’empreintes digitales de l’appareil. |
| carte | |||
| cardBin | true | number | Il s’agit du numéro d’identification bancaire de la carte (NIB). Il s’agit généralement des 6 à 8 premiers chiffres de la carte. |
callback
La fonction callback est invoquée pour gérer les erreurs ou notifier l’appelant avec l’identifiant de l’empreinte digitale de l’appareil.
| Paramètre | Requis | Type | Description |
|---|---|---|---|
| deviceFingerprintingId | false | string | Si l’opération réussit, l’identifiant de l’empreinte digitale de l’appareil est renvoyé. |
| error | false | object | Objet contenant des informations sur l’erreur. Ce champ est présent si l’opération échoue. Le contenu de cet objet est décrit ci-dessous. |
| error | |||
| code | true | string | Il s’agit du code d’erreur. |
| displayMessage | true | string | Il s’agit du message d’erreur qui s’affiche. |
| detailedMessage | false | string | Il s’agit d’une description détaillée de l’erreur. |
| correlationId | false | string | Il s’agit de l’identifiant unique de l’erreur qui doit être fourni au soutien Paysafe lors d’une enquête. |
Voici un exemple :
function callback(deviceFingerprintingId, error) {
if (error) {
// error handling
} else {
// manage a further call to the /authentications endpoint with the provided deviceFingerprintingId
}
}
Erreurs start
Les erreurs suivantes ne seront pas renvoyées par la fonction callback fournie, mais plutôt déclenchées.
Code | Message affiché | Message détaillé | Description |
|---|---|---|---|
| 9004 | Une erreur est survenue (9004); veuillez contacter notre service de soutien. | Callback doit être une fonction. | Le paramètre callback doit être une fonction valide. |
| 9012 | Une erreur s’est produite (9012); veuillez contacter notre service de soutien. | Nombre d’arguments non valides | Le nombre d’arguments fourni n’est pas 3. |
Un exemple de gestion des erreurs est présenté ci-dessous :
try {
paysafe.threedsecure.start(apiKey, options, (deviceFingerprintingId, startError) => {
// Regular callback function
});
} catch (e) {
//Handle the thrown exception
}
Erreurs transmises à callback
Les erreurs suivantes seront renvoyées par la fonction callback fournie.
Code | Message affiché | Message détaillé | Description |
|---|---|---|---|
| 9013 | Une erreur s’est produite (9013); veuillez contacter notre service de soutien. | Paramètre apiKey non valide. | Le paramètre apiKey fourni n’est pas une chaîne ou n’est pas une valeur valide encodée en Base64. |
| 9014 | Une erreur s’est produite (9014); veuillez contacter notre service de soutien. | Une erreur non gérée s’est produite. | Une erreur qui n’a pas été gérée par la SDK Paysafe.js a été déclenchée. |
| 9015 | Il y a eu une erreur (9015), veuillez contacter notre service de soutien. | Argument d’options non valide. | Le paramètre options fourni n’est pas un objet. |
| 9500 | Une erreur s’est produite (9500); veuillez contacter notre service de soutien. | Champs d’option non valides : ${options} non valide | Les valeurs transmises en tant qu’options ne sont pas valides. |
| 9501 | Une erreur s’est produite (9501); veuillez contacter notre service de soutien. | Configuration marchand non valide. | Utilisé lorsque la configuration marchand n’est pas valide |