Pour commencer

Téléchargez la SDK Python Paysafe à partir de GitHub

Avant d’utiliser une SDK, vous aurez besoin des authentifiants d’API (clé API) qu’elle utilise pour effectuer des requêtes JSON vers notre serveur via l’API REST de Paysafe.

• Votre nom d’utilisateur de clé API Paysafe.
• Votre mot de passe de clé API Paysafe.
• Votre numéro de compte Paysafe.

Pour obtenir votre compte de test, si vous avez l’intention d’utiliser la SDK Prélèvement automatique, contactez le soutien technique Paysafe, sinon cliquez sur Ouverture de session ci-dessus. Une fois connecté au Portail Paysafe vous pouvez récupérer votre numéro de compte (choisissez Comptes et copiez-le dans la colonne Compte) et votre nom d’utilisateur et mot de passe de clé API (choisissez Paramètres > Clé API). Pour plus d’informations, voir Authentification.

La SDK Python prend en charge les systèmes d’exploitation suivants :

• MS Windows XP
• MS Windows 7
• Ubuntu 14.04 (Linux)
• Mac OS X 10.9.5

Les rubriques qui suivent comprennent les commandes que vous devez effectuer à l’invite de commande.

Avant d’installer la SDK Python, vous devez d’abord télécharger Python 3.2.x ou une version plus récente à partir du https://www.python.org/downloads puis l’installer, comme décrit ci-dessous.

Vous pouvez vérifier votre version actuelle en exécutant ce qui suit :

python --version

Naviguez jusqu’au sous-dossier src et exécutez les commandes suivantes pour votre système d’exploitation :

Windows

La commande d’installation sous Windows est :

python setup.py install

puis installez le système de gestion des paquets pip en naviguant vers le dossier contenant get-pip.py et en exécutant ce qui suit :

python get-pip.py

Unix

La commande d’installation sous Unix est :

sudo python3 setup.py install

puis installez le système de gestion des paquets pip en exécutant ce qui suit :

sudo curl https://bootstrap.pypa.io/get-pip.py | python3

La SDK Paysafe Python a besoin du paquet de certification (version 14.5.14) pour pouvoir valider les certificats SSL lorsqu’elle effectue des opérations HTTPS. Installez-le à l’aide de la commande suivante pour votre système d’exploitation :

Windows

La commande d’installation sous Windows est :

python –m pip install certifi

Unix

La commande d’installation sous Unix est :

sudo python3 –m pip install certifi

La SDK Paysafe Python nécessite le client HTTP urllib3, que vous installez en utilisant la commande suivante pour votre système d’exploitation :

Windows

La commande d’installation sous Windows est :

python –m pip install urllib3

Unix

Les commandes d’installation sous Unix sont :

sudo python3 –m pip install urllib3

1. Naviguez vers le dossier sample_application.
2. Mettez à jour les paramètres suivants dans Config.py avec les authentifiants que vous avez générés lors de la création d’un compte sur le système Paysafe, en vous assurant que chaque valeur est incluse dans les guillemets correspondants.

   Clé	Valeur
   account_number	Votre numéro de compte Paysafe.
   api_key	Votre nom d’utilisateur de clé API Paysafe
   api_password	Votre Key password de API Paysafe
   currency_code	Le code de devise approprié, p. ex. USD
   currency_base_units_mulitplier	Les transactions sont en fait mesurées en fractions de la devise spécifiée dans le currency_code; par exemple, les transactions en USD sont mesurées en cents. Ce multiplicateur est le nombre de ces petites unités qui composent une des devises spécifiées. Par exemple, avec le currency_code USD, la valeur est 100, mais pour le YEN japonais, le multiplicateur est 1 car il n’y a pas d’unité plus petite.
   environment	TEST ou LIVE.

3. Par défaut, le serveur Python utilise le port 3000. Si vous ne voulez pas utiliser ce port, exécutez ce qui suit pour votre système d’exploitation :
   Windows:
   set PORT=required-server-port
   Unix:
   export PORT=required-server-port
4. Tapez la commande suivante pour démarrer le serveur Python :
   python ExecuteScriptServer.py
5. Si votre serveu Python fonctionne sur le port 3000, ouvrez un navigateur et accédez aux exemples d’URL ci-dessous, en remplaçant les valeurs des attributs par les valeurs réelles délimitées par des crochets <>. Si vous avez modifié le numéro de port dans l’étape précédente, substituez également le numéro que vous avez choisi par 3000.
   • http://localhost:3000/CreateProfile.py – pour créer un profil à l’aide de données fictives
   • http://localhost:3000/CreateCard.py?profileId=<profile_id>&cardNumber=<card_number> – pour la création d’une carte en utilisant des données fictives
   • http://localhost:3000/SilentHosted.py – for executing a Silent Post using dummy data
   • http://localhost:3000/SimpleHosted.py – for executing a Hosted Payment order using dummy data
   • http://localhost:3000/CardPayment.py?cardNumber=<card_number> – pour traiter un paiement par carte en utilisant des données fictives
   • http://localhost:3000/CardCustomer.py?paymentToken=<card_payment_token> – pour traiter un paiement à l’aide d’un jeton fictif

Pour que la SDK Python fonctionne avec votre application marchand, le serveur hébergeant l’application doit pouvoir se connecter au serveur Paysafe correspondant :

• TEST – le serveur Paysafe Test
• LIVE – Le serveur Paysafe Production

Les paramètres de configuration d’environnement suivants pour les deux serveurs sont définis dans le fichier script, src\bin\Environment.py :

• connection_timeout – le nombre de secondes que la SDK Python attend pour établir une connexion avec l’API Paysafe avant l’expiration du délai d’attente.
• host_url – l’URL de base de la requête API
• max_connections – le nombre maximum de connexions par réserve de connexions dans la SDK Python
• pool_enable – activer (défini sur ‘True’) ou désactiver (définir sur ’False’) une réserve de connexions. Pour effectuer des requêtes répétées, activez une réserve.
• read_timeout – une fois la connexion à l’API Paysafe établie, le nombre de secondes pendant lesquelles la SDK Python attend que l’API réponde aux requêtes avant l’expiration du délai d’attente.

Pour initialiser la SDK Paysafe dans votre application, utilisez les commandes suivantes :

1. Importez le fichier de configuration contenant votre clé API, etc.
   from Config import Config
2. Importez le module PaysafeApiClient dans votre application :
   from PythonPaysafeSDK.PaysafeApiClient import PaysafeApiClient
3. Créez l’API client Paysafe pour initialiser la SDK
   client = PaysafeApiClient(Config.api_key, Config.api_password, Config.environment, Config.account_number)

Pendant l’initialisation de la SDK, vous pouvez modifier les paramètres d’environnement du serveur à l’aide de cette commande :

Environment(host_url, max_connections, pool_enable, connection_timeout, read_timeout)

Par exemple :

environment_url['TEST'] = Environment('api.test.paysafe.com', 10, True, connection_timeout=30, read_timeout=30)

Les rubriques suivantes contiennent des exemples de code pour chaque API :

• API Paiements par carte – traite toutes les principales cartes de crédit via la passerelle de paiement Paysafe.
• API Prélèvement automatique – traite les achats et les crédits par le biais de divers systèmes bancaires.
• API Coffre-fort client – effectue des paiements répétés sans avoir à accéder directement aux renseignements sur le titulaire de carte.
• API 3D Secure – réduit la fraude tout en offrant une sécurité accrue aux clients qui utilisent leurs cartes en ligne.
• Exceptions – gère les différentes exceptions pour assurer un traitement précis des paiements.

Les exemples ci-dessus n’incluent pas l’initialisation.