Code wiki

Contenu

Cette étape vous permet de créer un compte de test dans l’environnement d’homologation, nécessaire pour l’intégration de Payline.

Vous avez déclaré votre société au registre du commerce, possédez un n° de SIRET et une adresse email valide. Suivez pas à pas les indications suivantes :

Inscription sur le site www.payline.com

Saisissez les informations relatives à votre société en prêtant une attention particulière aux informations suivantes :
- Raison sociale : nom de votre société déclarée au registre du commerce
- N° SIRET : numéro déclaré au registre du commerce.
- Adresse email du correspondant commercial et technique

Créez votre compte utilisateur en remplissant le formulaire suivant :
- Nom et prénom utilisateur
- Adresse email : cette adresse de messagerie sera utilisée comme identifiant utilisateur sur le Centre d’Administration Commerçant.
- Mot de passe utilisateur : Pour bien protéger votre compte, choisissez un mot de passe facile à mémoriser pour vous mais difficile à trouver par un autre. Ne communiquez jamais votre mot de passe à quelqu’un d’autre. Pour des raisons de sécurité votre mot de passe doit contenir au minimum 8 caractères constitués d’une combinaison de majuscules, de minuscules, de chiffres et de caractères spéciaux comme +, ?, *. Par exemple : « Jean-pierre09 » est un mot de passe conforme.
- Question et réponse secrète : en cas d’oubli du mot de passe.

Sélectionnez le pack Payline adapté à votre besoin et cliquez sur « Terminer »

A la fin du processus d’inscription, vous obtenez :

Vous recevrez par email :

votre identifiant commerçant et la clé d’accès associée qui permet à vos serveurs de communiquer avec les serveurs Payline.
votre identifiant utilisateur et le mot de passe qui vous permet de vous connecter au Centre d’Administration Commerçant Payline.

Étape 1 - Créer un compte de test

Étape 2 - Configurez votre compte

Cette étape vous permet de configurer votre compte de test via le centre d’administration commerçant.
A l’aide de votre navigateur Internet, allez à l’adresse suivante : https://homologation-admin.payline.com
Saisissez votre identifiant commerçant, votre identifiant utilisateur et votre mot de passe et cliquez sur « Se connecter »
Cliquez sur le menu « Configuration » et le sous menu « Vos points de vente », puis cliquez sur votre unique point de vente créé par défaut à la création de votre compte. Complétez alors le formulaire qui précise le fonctionnement attendu de votre point de vente. Remarque : sur cette page vous pouvez également créer de nouveaux points de vente en cliquant sur le bouton « Créer un point de vente ».

Exemple pour un site d’e-commerce : Renseignez le formulaire de la façon suivante :
Activer ce point de vente : oui
Libellé : POS mon-site
Mail webmaster : webmaster@mon-site.com
Langue : Français
Commentaire : vide
URL Boutique : http://www.mon-site.com
URL de notification : vide
URL protection de la vie privée : vide
Ticket de paiement au commerçant : oui
Ticket de paiement à l’acheteur : oui
Redirection automatique vers la boutique à la fin du paiement : oui
Le client doit accepter les conditions générales de vente pour effectuer le paiement : non
Cliquez sur le menu « Configuration » et le sous-menu « Vos points de vente », puis cliquez sur le bouton « Nouveau moyen de paiement » afin d’ajouter un nouveau moyen de paiement sur votre point de vente « POS mon-site ».

Afin de pouvoir utiliser un nouveau moyen de paiement en production, vous devez au préalable obtenir un contrat de vente à distance auprès de l’organisme acquéreur. En environnement d’homologation, aucun contrôle ne sera effectué. Vous êtes donc libre de tester l’ensemble des moyens de paiement proposés.

Une fois votre point de vente et ses moyens de paiement configurés, la page d’accueil du centre d’administration (accessible via un clic sur le lien « Accueil » dans la barre de menu) vous le confirme :
Configuration du compte
Configuration d’un point de vente
Configuration d’un moyen de paiement

Étape 3 - Testez immédiatement avec les pages exemples fournies

Cette étape vous permet de vous assurer que votre compte est correctement configuré en utilisant des pages exemples téléchargeables sur le site Internet www.payline.com.
Les pages exemples sont proposées dans un kit d’intégration et sont disponibles pour les plateformes PHP, .NET et JAVA.
Une fois les pages exemples téléchargées, vous devez suivre les indications du fichier readme.txt :
Mettez à jour votre plateforme de test et activez les librairies nécessaires.
Installez et configurez les pages d’exemples avec les éléments suivants :
merchantID : vous devez entrer l’identifiant commerçant qui vous a été communiqué lors de votre inscription.
merchantAccesskey : vous devez entrer la clé commerçant qui vous a été communiquée lors de votre inscription. Si vous avez perdu votre clé d’accès, vous pouvez en régénérer une nouvelle sur le Centre d’Administration Payline.
contractNumber : vous devez entrer le n° de contrat VAD que vous avez renseigné lors de l’activation d’un moyen de paiement sur votre compte commerçant.
proxyInternet : vous devez préciser si votre connexion Internet nécessite le paramétrage d’un proxy Internet. En effet, si vous testez depuis un ordinateur connecté à un réseau d’entreprise, vous avez de grande chance d’être connecté à Internet au travers d’un proxy Internet. Dans ce cas, il vous suffit de préciser le nom DNS et le port de la façon suivante :
proxy = proxy.monentreprise.com
port = 8080
Démarrez votre serveur web
A l’aide de votre navigateur Internet, allez sur l’url « http://localhost/payline/ ». Si vous utilisez un port différent du port 80, vous devez le préciser comme ceci :
Par exemple : port 9000 à http://localhost:9000/payline/
Sur la page d’accueil, cliquez sur l’onglet « web »
Page 1 : La page présentée simule la page « Récapitulatif d’une commande » de votre site d’e-commerce. En cliquant sur le bouton « Start Payment Process », elle initialise une demande de paiement en transmettant à Payline une référence de commande unique (order.Ref), un montant multiplié par 100 (order.Amount), le code ISO de la devise (order.Currency), les moyens de paiement à proposer à votre client, etc.
Page 2 : Cette page fait partie des pages web de paiement Payline. Elle permet à votre client de choisir son moyen de paiement. Elle est personnalisable à votre enseigne (couleur, texte, logo, etc.) et peut ne pas être affichée dans le cas où un seul moyen de paiement est proposé. Pour plus d’information, veuillez vous reporter à la documentation Manuel utilisateur du centre d’Administration.
Page 3 : Entrez dans cette page le n° de carte de test approprié au moyen de paiement que vous avez sélectionné. Si vous avez sélectionné la carte VISA comme moyen de paiement, vous pouvez utiliser la carte de test n° 4970 1000 0032 5734 avec une date d’expiration valide et le cryptogramme visuel 123. Vous trouverez dans la documentation annexe spécification fonctionnelle par carte, le n° de carte de test que vous devez utiliser pour les cartes autres que VISA.
Page 4 : Cette page informe votre client de l’accord ou du refus de paiement. Cliquez sur le bouton « Terminer le paiement » pour terminer le processus de paiement et simuler le retour sur le site commerçant.
Page 5 : La page présentée vous permet de visualiser le message retour que vous allez pouvoir obtenir suite à un paiement web. Elle récupère le résultat de la transaction auprès de Payline en transmettant le jeton d’authentification (token) associé à votre commande. L’identifiant de la transaction Payline et le n° d’autorisation délivré en cas d’accord de débit de l’acquéreur vous sont communiqués.
Si vous avez besoin d’aide lors de ce test, veuillez contacter le service support Payline à l’adresse suivante support@payline.com

Étape 4 - Intégrez dans votre application

Vous pouvez maintenant choisir votre façon d’intégrer la solution de paiement Payline dans votre application.
Il existe trois solutions pour utiliser Payline :
Suite e-commerce : une utilisation immédiate
Utilisez une suite e-commerce certifiée Payline et n’ayez aucune intégration à effectuer. La liste des suites d’e-commerce qui propose la solution de paiement Payline est disponible sur demande auprès de notre assistance technique Payline.
Kit d’intégration : une installation facilitée
Intégrez Payline à l’aide d’un kit. Vous devez avoir des connaissances du langage HTML et d’un langage de scripts tels que PHP, C# et Java pour l’utilisation du kit d’intégration sélectionné.
API SOAP : une intégration complète
Intégrez Payline à l’aide de l’API SOAP. Vous devez maitriser le développement d’interface client avec des services standards web sécurisés.

Étape 5 - Validez votre intégration

Cette étape vous permet de contrôler que votre intégration est correcte.
Lors de votre inscription, vous avez du recevoir de notre équipe support, un PV de Recette qui vous décrit les tests à réaliser.
Consultez le centre d’administration commerçant et validez le bon enregistrement de vos transactions de paiement.

Étape 6 - Demandez l'activation de votre compte en production

Lorsque vous avez validé l’intégration de Payline dans votre application, activez votre compte en production en suivant les indications suivantes :
Téléchargez les conditions générales d’utilisation du service Payline disponible sur le site Internet www.payline.com.
Retournez le bon de commande complété et signé à notre service commercial email : subscribe@payline.com
Et transmettez votre ou vos contrats de vente à distance ainsi que le PV de recette signée au service support Payline par email : support@payline.com

Réaliser des transactions pilotes en production afin de vérifier le fonctionnement et le paramétrage des contrats.