Initialiser la SDK
Aperçu
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.
Si l’émetteur de la carte exige que l’utilisateur effectue un défi 3DS avant de confirmer l’authentification, il suffit de transmettre le contenu du défi à la SDK, qui le traitera à l’aide d’une interface utilisateur native et intuitive. La SDK Paysafe prend actuellement en charge les versions 3DS 1.0.2 (via webview uniquement) et 2.1.0. Pour de plus amples renseignements sur le flux de transactions 3D Secure, cliquez ici : Introduction à 3D Secure 2
Pour traiter les paiements par carte 3DS dans votre application, vous avez besoin de deux composants :
- L’API Client Paysafe
- Le ThreeDSecureService
Initialiser l’API Client Paysafe
L’API Client Paysafe est le composant qui gère la communication HTTP avec les API REST Paysafe. Transmettez les paramètres suivants lors de son initialisation par l’application :
- Identifiant d’utilisateur du marchand (enregistrée Paysafe API Key username)
- Mot de passe Paysafe du marchand (enregistrée Paysafe API Key password)
- Numéro de compte du marchand (numéro de compte Paysafe enregistré)
- Environnement (TEST/DIRECT)
Ces paramètres sont stockés dans un seul fichier .plist et ne sont requis qu’au démarrage de l’application ou lorsqu’il est nécessaire de définir plusieurs fournisseurs de manière dynamique. Il y a deux façons de procéder à l’initialisation :
- En définissant l’identifiant du marchand et le mot de passe Paysafe du marchand
- En fournissant directement la clé API
Voici un exemple d’initialisation de l’API Client Paysafe :
PaysafeSDKMerchantConfiguration *merchantConfiguration = [[PaysafeSDKMerchantConfiguration alloc] initWithUsername: <Your Merchant User ID>
password: <Your Merchant Paysafe Password>
accountId: <Your Merchant Account Number>];
PaysafeSDK.currentEnvironment = .test
PaysafeSDK.merchantConfiguration = PaysafeSDK.MerchantConfiguration(username: <Your Merchant User ID>,
password: <Your Merchant Paysafe Password>,
accountId: <Your Merchant Account Number>)
Par défaut, currentEnvironment est défini sur production dans la SDK si rien n’est spécifié.
Voici un exemple d’initialisation de l’API Client Paysafe avec apikey :
let merchantConfiguration = PaysafeSDK.MerchantConfiguration(apiKey: <Your Merchant API Key>,
accountId: <Your Merchant Account Number>)
Initialiser ThreeDSecureService
Le ThreeDSecureService fournit la logique nécessaire à la génération d’une empreinte digitale de l’appareil et au traitement d’un défi 3DS entrant.
Voici un exemple de création d’une instance de ThreeDSecureService :
ThreeDSecureService *service = [[ThreeDSecureService alloc] init];
// config est la configuration marchand qui serait utilisée. Si vous n’avez pas besoin d’une configuration marchand différente pour chaque appel,
// vous pouvez en définir une qui soit statique via PaysafeSDK.merchantConfiguration.
let service = ThreeDSecureService(merchantConfiguration: config)
// sinon, il suffit d’appeler le service de cette façon
let service = ThreeDSecureService()
Vous pouvez également fournir des options de personnalisation pour les écrans de défi 3DS lors de l’initialisation du ThreeDSecureService.