Pour commencer
Télécharger la SDK
Téléchargez la SDK Java Paysafe à partir de GitHub
Avant de commencer
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.
Installation
Pour installer la SDK Java, vous devez avoir installé JDK 1.6 ou une version ultérieure. Toutes les autres exigences seront automatiquement téléchargées lors du lancement de l’application modèle.
Les étapes suivantes décrivent comment configurer et lancer l’application modèle sur un système Unix.
Personnaliser votre configuration
Une fois la SDK installée, vous devrez modifier votre fichier de configuration avec vos authentifiants Paysafe.
- Installez Gradle en exécutant la commande suivante :
sudo Gradle build - Ouvrez le fichier de configuration à partir de SDK Java/samples /samples/src/main/resources/config.properties et mettez à jour les données suivantes :
| Clé | Valeur |
|---|---|
| accountNumber | Votre numéro de compte Paysafe. |
| apiKey | Votre nom d’utilisateur de clé API Paysafe |
| apiPassword | Votre Key password de API Paysafe |
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 |
Lancez l’application modèle
- Dans votre interface de ligne de commande, naviguez jusqu’au répertoire racine de la SDK et exécutez la commande suivante :
sudo Gradle jettyRun - Ouvrez un navigateur Web et naviguez jusqu’à http://localhost:8181/samples.
- Utilisez les liens pour exécuter l’application modèle.
Initialiser la SDK dans votre application
Pour initialiser les paramètres de l’environnement serveur et les authentifiants API dans votre application, utilisez la commande
PaysafeApiClient apiClient = new PaysafeApiClient(this.apiKey, this.apiPassword, Environment.TEST, this.accountNumber);
La SDK Java utilise des configurations par défaut pour des paramètres tels que connection_timeout et max_connections. Ces paramètres ne peuvent pas être configurés en externe.
Exemple de code
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.
Pour télécharger une version française de ce guide au format PDF, cliquez ici.