Pour commencer

Téléchargez la SDK PHP 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.

Pour utiliser la SDK PHP, vous devez avoir installé PHP 5.5 ou version ultérieure et cURL. De plus, vous devez pouvoir utiliser cURL pour établir une connexion SSL aux points d’extrémité API à partir de votre environnement d’hébergement. Si des erreurs cURL sont renvoyées, effectuez un dépannage de connectivité dans votre environnement d’hébergement.

La SDK PHP fonctionne sous les systèmes d’exploitation suivants :

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

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

Vous pouvez également effectuer un appel dans votre application vers la méthode statique suivante en utilisant le chemin d’accès à votre certificat CA :

\Paysafe\PaysafeApiClient::setCACertPath(_PATH_TO_CERTIFICATE_);

1. Naviguez jusqu’au dossier /sample et mettez à jour les paramètres suivants dans config.php avec vos propres authentifiants, en veillant à ce que chaque valeur soit placée entre des guillemets correspondants.
    

   Clé	Valeur
   $currencyBaseUnitsMultiplier	Les transactions sont en fait mesurées en fractions de la devise spécifiée dans le $currencyCode; 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 $currencyCode USD, la valeur est 100, mais pour le YEN japonais, le multiplicateur est 1 car il n’y a pas d’unité plus petite.
   $currencyCode	Le code de devise approprié, p. ex. USD
   $paysafeAccountNumber	Votre numéro de compte Paysafe.
   $paysafeApiKeyId	Votre Key username de API Paysafe
   $paysafeApiKeySecret	Votre Key password de API Paysafe

    

   Pour que la SDK PHP 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

   Par défaut, les exemples d’applications utilisent le serveur TEST. Cela est défini au début de chaque fichier de configuration de l’application dans le fichier du dossier /sample (les fichiers *.php autres que config.php).

   2. Pour exécuter l’exemple d’application en utilisant le serveur Web intégré PHP et le fichier index.html, tapez : php -S localhost:8081

   3. Ouvrez un navigateur Web et naviguez jusqu’à http://localhost:8081.

   4. Dans la page qui s’affiche, utilisez les liens pour exécuter les exemples d’applications.

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

1. Importez le fichier de configuration contenant votre clé API, etc.
   require_once(’config.php’);
2. Mettez les environnements de serveur à la disposition de votre application :
   use paysafe\environment;
   use paysafe\paysafeapiclient;
3. Créez l’API client Paysafe Par exemple, pour utiliser le serveur Test, veuillez inclure la ligne :
   $Paysafe_api_object = new PaysafeApiClient($paysafeApiKeyId, $paysafeApiKeySecret, Environment::TEST, $paysafeAccountNumber);
   Pour utiliser le serveur Live, remplacez TEST par LIVE.

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 et 3D Secure 2 – atténue le risque de 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.

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