1. Paramètres du compte de test
Pour commencer, demander les paramètres de connexion au compte d’homologation (test) à l'administrateur commerçant, qu’il a reçu par email en créant son compte test.
Si le compte commerçant de test n’est pas créé, vous devez envoyer une demande à sales@payline.com.
L'administrateur commerçant pourra vous créer un utilisateur de connexion afin de récupérer la clé API.
2. Définir le mode d'intégration
- Mode web
Payline met à disposition des web services de paiement pour réaliser les demandes de paiement à partir de votre page web de paiement. Consulter la documentation.
- Kits d'intégration ou module
Payline a mis à votre disposition, des kits d'intégrations (.NET, JAVA et PHP) et modules (Prestashop, Magento, etc.).
Pour chaque kit d’intégration ou module, une documentation d'installation et de configuration est associée. Veuillez consulter la documentation et télécharger le kit ou le plugin.
3. Quels sont les tests à faire ?
Les tests que vous devez faire dépendent de vos besoins et de votre offre.
Les tests obligatoires sont:
- Autorisation simple acceptée
- Autorisation simple refusée
- Autorisation + Validation acceptée
- Autorisation + Validation refusée
- Validation de transaction
- Annulation de transaction
- Remboursement de transaction
- Vérifier que les transactions sont notifiées
Les détails des opérations :
- Pour effectuer une autorisation simple, le code action doit être 100.
- Pour effectuer une autorisation + Validation immédiate, le code action doit être 101.
- Pour effectuer une transaction refusée, il faut que la transaction ait un montant spécifique. Ces montants sont dans le document à sur ce lien.
- Une transaction d'autorisation non validée, et donc remise à votre acquéreur jusqu'à la validation.
Le commerçant ne percevra pas l'argent.
Une telle transaction expire au bout 7 jours. Passé ce délai, la transaction est n'est plus valide : si elle est capturée, la banque ne garantit pas que la somme soit toujours disponible sur le compte de l'acheteur. - Pour annuler ou rembourser une transaction, aller dans le menu :
Transaction > Gérer vos transactions. - Une notification sera envoyée. Pour plus d'information sur la notification, veuillez consulter la documentation sur La notification par URL.
Cas de prélèvement à expédition
Si vous comptez prélever l'acheteur à l'expédition, deux solutions sont possibles:
Cas 1: Vous allez expédier la commande avant 7 jours.
Faire une autorisation simple (code action 100) puis valider la transaction à l'expédition dans les 7 jours.
Cas 2: Vous allez expédier la commande après 7 jours.
Là encore, il y a deux possibilités:
- Possibilité 1: faire la ré-autorisation pour rafraîchir l'autorisation initiale de 7 jours supplémentaires.
- Possibilité 2: Créer un wallet (portefeuille virtuel) au moment de la commande. Faire un prélèvement sur le portefeuille à l'expédition de la commande.
Remarques:
1. Ré-autorisation = offre Easy Pack ou supérieure + activation de l’option dans le moyen de paiement
2. La ré-autorisation et le paiement par portefeuille sont des transactions qui peuvent être refusées par les banques.
Cas de paiement en plusieurs fois
Vous souhaitez que les acheteurs puissent payer en plusieurs fois ou par un système d'abonnement.
Créer une transaction en mode NX ou REC, la documentation se trouve sur ce lien.
Cas de paiement par portefeuille ou one-click
Vous voulez que dès la première transaction, les données de paiements soient stockées chez Payline. Pour les prochaines transactions, l'acheteur pourra payer sans saisir à nouveau ses coordonnées bancaires.
Créer un portefeuille (createWallet ou createWebWallet).
Créer un portefeuille lors d’une transaction web (doWebPayment en spécifiant le buyer.walletId).
Cas de paiement différé
Vous souhaitez faire une transaction d'autorisation simple (code action 100) qui sera validée automatiquement dans 1, 2, 3, 4, 5, 6 ou 7 jours.
Créer un paiement en mode DIF
Vous disposez d'un portefeuille ou wallet et souhaitez faire un prélèvement à une date.
La date est "Maintenant": utiliser le service web doImmediateWalletPayment.
La date est "future": doScheduledWalletPayment.
Cas de paiement en 3D Secure
Le 3D Secure est un système de sécurité supplémentaire lors d'une transaction. Généralement, un code sms ou la date de naissance est demandée à l'acheteur.
Pour pouvoir tester cette fonction, demander que le 3D Secure soit activé sur votre moyen de paiement CB/VISA/MASTERCARD ou AMEX.
Faire une transaction en suivant le cycle 3D Secure.
En mode web, vous faites directement des transactions avec des cartes de tests 3D Secure.
Cartes de tests disponibles sur ce lien.
Cas de lutte contre la fraude (LCLF)
Payline dispose d'un outil de lutte contre la fraude que vous pouvez tester. Vous pouvez par exemple refuser toutes les transactions en provenance d'un pays donné que vous jugez sensible. La documentation du LCLF se trouve à ce lien.
4. Passage en production
Cette étape suppose que les tests sont terminés et que le commerçant est prêt à accepter des transactions réelles.
Lors de la création du compte test, le commerçant a reçu par email, le dossier de souscription. Ce document comporte les pièces suivantes:
- Un contrat
- Un mandat de prélèvement
- Un RIB
- Un PV de recette
Ces documents doivent être remplis, signés et renvoyés à l’adresse indiquée dessus. Une fois reçus par Payline, le commerçant reçoit par mail, les paramètres de production.
- Les identifiants de production sont différents de ceux d’homologation.
- Il faut régénérer une nouvelle clé d’accès (configuration -> gestion des clés d’accès)
- Il faut spécifier que le site est en production. Si vous ne le faites pas, lors de la transaction, votre serveur tentera de se connecter au serveur de test plutôt qu'au serveur de production Payline. Vous aurez une erreur "unauthorized".
- Les identifiants ne doivent pas comporter d'espaces.
- Vous trouverez les numéros de contrat dans le menu : Configuration > Moyens de paiements > Rechercher