Pour commencer

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

Avant d’installer la SDK Ruby, vous devez d’abord télécharger la dernière version de Ruby à partir de https://www.ruby-lang.org/en/downloads.

Naviguez jusqu’au dossier racine du projet et exécutez les commandes suivantes pour construire et installer la gemme et rails, pour mettre à jour JSON à la bonne version et pour installer le logiciel requis pour la SDK :

gem build paysafe.gemspec

gem install paysafe

gem install rails

bundle update json

bundle install

Sous Windows, pour pouvoir effectuer des opérations HTTPS, définissez la variable d’environnement suivante pour indiquer un certificat CA valide sur votre système :

SSL_CERT_FILE

1. A partir du dossier Ruby racine, naviguez jusqu’au dossier :
   \sample_rails_app\config\environments
2. Dans un éditeur de texte, ouvrez le fichier development.rb et mettez à jour les paramètres suivants avec vos propres authentifiants, en vous assurant que chaque valeur est entourée de guillemets correspondants.

   Clé	Valeur
   currency_code	Le code de devise approprié, p. ex. USD
   currency_base_units	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.
   paysafe_account_number	Votre numéro de compte Paysafe.
   paysafe_api_key	Votre Key username de API Paysafe
   paysafe_api_secret	Votre Key password de API Paysafe

   
   Dans un environnement de production, vous devez traiter le fichier production.rb.
3. Exécutez les commandes suivantes pour démarrer le serveur Ruby :
   rails server
4. Ouvrez un navigateur Web et naviguez jusqu’à http://localhost:3000.

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

1. Dans le dossier Ruby racine, ouvrez le fichier de configuration :
   \sample_rails_app\config\environments\development.rb

2. Créez l’objet client Paysafe en utilisant les paramètres du tableau ci-dessus.

   client = Paysafe::Paysafe:PaysafeApiClient.new(config.paysafe_api_key,config.paysafe_api_secret, Paysafe::Environment::TEST,config.paysafe_account_number )

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.