Générer l’empreinte digitale de l’appareil
Remarque : En tant que partenaire ISV/Paysafe, vous devrez effectuer toutes les étapes « marchand » ci-dessous au nom de l’entité juridique mère des marchands (PMLE) sous laquelle vos marchands exerceront leurs activités.
La première étape du traitement d’un paiement par carte 3DS consiste à générer l’empreinte digitale de l’appareil.
- Commencez par transmettre le NIB de la carte à la méthode start() de ThreeDSecureService.
La méthode start() appellera ensuite completionlorsqu’une empreinte digitale de l’appareil est générée.
[self.threeDSecureService startWithCardBin: "411111"
completion: ^(NSString * _Nullable deviceFingerprintId, NSError * _Nullable error) {
if (error) {
// Traitez l’erreur
} else if(deviceFingerprintId) {
// Utilisez l’empreinte digitale générée de l’appareil pour créer une authentification
}
}];
threeDSecureService.start(cardBin: "411111",
completion: { deviceFingerprintingId, error in
if error {
// Traitez l’erreur
} else if deviceFingerprintId {
// Utilisez l’empreinte digitale générée de l’appareil pour créer une authentification
}
})
- Transmettez l’empreinte digitale de votre appareil à votre serveur.
Le serveur doit appeler le point d’extrémité /authentications des API REST Paysafe. La réponse de l’appel /authentications contient les données utiles du défi 3DS, qui sont gérées par votre application.
Si la SDK ne parvient pas à générer une empreinte digitale, vous recevrez un message d’erreur ThreeDSecureError contenant des informations utiles sur la cause de l’échec. Lors du dépannage, vous pouvez commencer par vérifier le code d’erreur et le message détaillé. Vous pouvez consulter ci-dessous les codes d’erreur actuellement pris en charge :
| Code d’erreur | Valeur | Explication |
|---|---|---|
| ERROR_CODE_CONNECTION_FAILED | 9001 | L’opération a échoué en raison d’un délai d’inactivité ou d’un problème de connectivité. |
| ERROR_CODE_INVALID_RESPONSE | 9002 | Le serveur a renvoyé un format de données non valide qui n’a pas pu être traité par la SDK. |
| ERROR_CODE_INVALID_API_KEY | 9013 | Clé API ou secret API non valide fourni lors de la création d’une API Client Paysafe. |
| ERROR_CODE_INTERNAL_SDK_ERROR | 9014 | Une erreur générale de la SDK. Le message détaillé doit fournir des informations supplémentaires. |
| ERROR_CODE_INVALID_OPTIONS | 9015 | Erreur de champs d’option non valides. Le message détaillé doit fournir des informations supplémentaires. |
| ERROR_CODE_INVALID_MERCHANT_CONFIGURATION | 9501 | La configuration du compte marchand fourni n’est pas valide. L’équipe de soutien de Paysafe doit être informée. |
| ERROR_CODE_TRANSACTION_FAILED_OR_CANCELED | 9601 | L’opération a échoué en raison d’une annulation ou d’un échec. |
Si vous ne parvenez pas à résoudre le problème par vous-même, vous pouvez contacter le service de soutien de Paysafe à l’adresse suivante integrations@paysafe.com et fournir l’identifiant de corrélation de l’erreur.