Pour commencer

Téléchargez la SDK Paysafe Node.js à 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.

• Téléchargez Node.js à partir de https://nodejs.org/download/.
  Les rubriques qui suivent comprennent les commandes que vous devez effectuer à l’invite de commande.

1. Naviguez vers le dossier sample_application.
2. Mettez à jour les paramètres suivants dans config.js avec vos propres authentifiants, en vous assurant que chaque valeur est incluse entre guillemets correspondants.
    

   Clé	Valeur
   currency_base_units_multiplier	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.
   currency_code	La devise de votre compte, par exemple USD
   paysafeAccountNumber	Votre numéro de compte Paysafe.
   paysafeApiKeyId	Votre Key username de API Paysafe
   paysafeApiKeySecret	Votre Key password de API Paysafe
   paysafeEnvironment	TEST ou LIVE. Voir Initialiser la SDK dans votre application pour de plus amples renseignements.

3. Utilisez le gestionnaire de paquets, npm, pour installer le module Request à utiliser pour les appels HTTP en exécutant ce qui suit :
   npm install request
4. Utilisez npm pour installer le cadre d’application Web Node Express en exécutant ce qui suit :
   npm install express
5. Par défaut, le serveur utilise le port 3000. Si vous ne voulez pas utiliser ce port, exécutez ce qui suit :
   Windows:
   set PORT=required-server-port
   Unix:
   export PORT=required-server-port
6. Tapez la commande suivante pour démarrer le serveur :
   node server.js
7. Si votre serveur Node.js 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 – for creating a profile using dummy data
   • http://localhost:3000/createCard?profileId=<profile_id>&cardNumber=<card_number> – pour la création d’une carte en utilisant des données fictives
   • http://localhost:3000/silentHosted – for executing a Silent Post using dummy data
   • http://localhost:3000/simpleHosted – for executing a Hosted Payment order using dummy data
   • http://localhost:3000/cardPayment?cardNumber=<card_number> – pour traiter un paiement par carte en utilisant des données fictives
   • http://localhost:3000/cardCustomer?paymentToken=<card_payment_token> – pour traiter un paiement à l’aide d’un jeton fictif

Pour que la SDK Paysafe Node.js fonctionne avec votre application de marchand, le serveur hébergeant l'application doit pouvoir se connecter au serveur Paysafe concerné :

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

Les URL de ces serveurs, ainsi que les paramètres de configuration de l’environnement suivants, sont définis dans le fichier script, /bin/Environment.js.

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

1. Importez la SDK Paysafe :
   var paysafeApiClient = require("PaysafeApiClient");
2. Importez le fichier de configuration contenant votre clé API, etc.
   var config = require("./config");
3. Create the Paysafe API Client object.
   var paysafeApiClient = new paysafeApiClient(config.paysafeApiKeyId, config.paysafeApiKeySecret, config.paysafeEnvironment, config.paysafeAccountNumber);

Pour modifier les paramètres de configuration de l'environnement, utilisez :
paysafeApiClient.updateConfig(host, maxSockets, timeOut);

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.