Instructions de test
Aperçu
L’environnement de test Paysafe peut être utilisé pour tester des sites Web ou des applications sans effectuer de transactions sur la plateforme de traitement en mode production (en direct). Les opérations de paiement (p. ex. carte de crédit ou prélèvement automatique) traitées dans l’environnement de test ne sont pas envoyées au réseau bancaire, mais passent par un simulateur. En fonction des informations fournies dans la requête de transaction, le simulateur renvoie une réponse positive (approuvée) ou négative (refusée).
Avec l’API Paysafe, vous pouvez tester les éléments suivants :
- Vérifier la prise en charge de tous les types d’opérations dont vous avez besoin.
- Passer en revue toutes les erreurs courantes ainsi que les erreurs susceptibles de se produire pour chaque opération, et veiller à ce que votre application soit en mesure de les traiter.
- Vérifier la longueur et le format de tous les attributs envoyés.
L’API Paiements par carte vous permet également de simuler des réponses spécifiques en utilisant des valeurs spéciales pour les paramètres amount, cvv et street de la requête.
Demande d’un compte de test
Vous pouvez demander un compte de test en cliquant sur le bouton SIGN UP.
Votre compte de test vous permettra d’accéder à une version de test de l’arrière-guichet marchand Paysafe, où vous pouvez consulter l’état de vos opérations de test. Une fois connecté à l’arrière-guichet, vous devez également récupérer votre numéro de compte (choisir Comptes et le copier depuis la colonne Compte) et votre nom d’utilisateur et mot de passe de la clé API (choisir Paramètres > Clé API); le mot de passe est également disponible encodé en Base64.
Vous pouvez utiliser le compte par défaut pour traiter les paiements par carte Visa et Mastercard (à l’aide des API Paiements par carte, Coffre-fort client, Paiements hébergés et 3D Secure). Des numéros de carte spéciaux sont disponibles à des fins de test de ces API et pour utilisation avec Paysafe.js.
N’utilisez pas de numéros de cartes réels ou d’autres données relatives à des instruments de paiement dans l’environnement de test marchand, car il n’est pas conforme aux normes de sécurité des données de l’industrie des cartes de paiement (PCI-DSS) et ne protège pas les informations relatives au titulaire de la carte ou au bénéficiaire du paiement. Tout téléversement de données réelles de titulaires de cartes est strictement interdit, comme décrit dans les conditions d’utilisation..
Vous devrez ouvrir des comptes distincts pour les paiements par prélèvement automatique (un compte pour chaque méthode de prélèvement automatique que vous souhaitez utiliser : SEPA, TEF, BACS et ACH) et un compte pour chacun des modes de paiement alternatifs pris en charge par Paysafe que vous souhaitez utiliser (p. ex. SOFORT et BOKU). Par ailleurs, si vous souhaitez tester des paiements dans une autre devise prise en charge, vous aurez besoin de comptes supplémentaires pour chaque combinaison mode de paiement/devise; par exemple, prélèvement SEPA en EUR, prélèvement BACS en GBP, paiements par carte en EUR et paiements par carte en GBP. Contactez le service de soutien à l’intégration en mentionnant vos exigences, et on créera les comptes pour vous.
REMARQUE :Tous vos comptes peuvent être configurés pour être utilisés avec la même clé API. Veuillez contacter le service à la clientèle pour de plus amples renseignements.
Les comptes multiples sont résumés dans l’image suivante :
Tester un point d’extrémité d’API
Le point d’extrémité de l’API à utiliser pour les transactions de test est le suivant :
https://api.test.netbanx.com
Par exemple :
https://api.test.netbanx.com/hosted/v1/orders
Utiliser des devises avec des comptes de test
Les comptes test du Centre des développeurs prennent en charge le traitement et le règlement dans les devises suivantes :
- CAD - Dollar canadien
- GBP – Livre sterling
- EUR – Euro
- Dollar américain
Paysafe peut traiter et régler dans les devises suivantes :
- AUD
- CAD
- CHF
- DKK
- EUR
- GBP
- HKD
- NOK
- NZD
- PLN
- RUB
- SEK
- SGD
- TRY
- ZAR
Si vous souhaitez traiter dans une devise et régler dans une autre, contactez le service de soutien à l’intégration Paysafe.
Paysafe permet d’effectuer des paiements avec toutes les grandes marques de cartes. Cependant, le compte de test du Centre des développeurs ne prend en charge que les cartes American Express, Maestro, Mastercard, Visa et Visa Electron. Contactez le service de soutien à l’intégration si vous souhaitez activer d’autres marques pour votre compte de test.
Remplacer la devise par défaut
Vous pouvez remplacer la devise de traitement par défaut en spécifiant dans votre requête API le code de la devise à utiliser pour le traitement de la transaction (en utilisant le paramètre currencyCode). Par exemple :
"amount":10098,
"currencyCode" : "CAD",
Pour une liste des devises et des codes correspondants, voir Codes de devise.
Cette requête échouera si vous ne disposez pas d’un compte marchand qui accepte cette devise et ce mode de paiement. Le service de soutien à l’intégration Paysafe établit une correspondance entre la devise et un compte qui prend en charge cette devise.
Si vous avez plusieurs comptes marchands dans la même devise, vous devrez fournir un paramètre supplémentaire, le merchantAccount, qui agit de la même manière que le account_id dans les autres API REST, pour sélectionner le bon compte comme suit :
"amount":10098,
"currencyCode" : "CAD",
"extendedOptions" : [{
"key" : "merchantAccount",
"value" : "10036215"
}]
Comptes de test et de production
Les comptes de test vous permettent de traiter des transactions API qui reflètent les fonctionnalités de l’environnement de production. Une fois que vous êtes satisfait de votre intégration à l’environnement de test, vous devez répéter sur le compte de production toutes les modifications de configuration apportées à votre compte de test. Conservez un registre de toutes les modifications demandées et effectuées.
Vous devrez utiliser différents points d’extrémité API et identifiants d’authentification pour vous connecter à l’environnement de production Paysafe.
Pour de plus amples renseignements, voir Mise en service.