{

Étape 1 - Créer votre compte

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 :

Pour s'inscrire vous devez envoyer une demande a sales@payline.com avec

• 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

• un compte utilisateur  : 
  • 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.

Vous obtenez un email avec :

• 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 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 »

Point de vente 

Les étapes

En prérequis, vous devez avoir récupérer la clé d'API dans le centre administrateur avec votre connexion utilisateur fourni par l'administrateur commerçant.

1. Envoyer un paiement initial

Vous devez simplement initier une demande de paiement en appeler le service web doWebPayment de serveur à serveur avec les paramètres contrats sélectionnés et les données de la commande.

Développer
title Exemple d'une requête au service de paiement..
Bloc de code language xml theme Confluence <ns1:doWebPaymentRequest xmlns:ns2="http://obj.ws.payline.experian.com" xmlns:ns1="http://impl.ws.payline.experian.com" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ns1:version>20</ns1:version> <ns1:payment> <ns2:amount>33300</ns2:amount> <ns2:currency>978</ns2:currency> <ns2:action>101</ns2:action> <ns2:mode>CPT</ns2:mode> <ns2:contractNumber>VADCB</ns2:contractNumber> </ns1:payment> <ns1:returnURL>https://demo.payline.com/~kitphp/examples/demos/web.php?e=getWebPaymentDetails</ns1:returnURL> <ns1:cancelURL>https://demo.payline.com/~kitphp/examples/demos/web.php?e=getWebPaymentDetails</ns1:cancelURL> <ns1:order> <ns2:ref>REF001</ns2:ref> <ns2:amount>33300</ns2:amount> <ns2:currency>978</ns2:currency> <ns2:date>22/01/2019 17:33</ns2:date> </ns1:order> <ns1:notificationURL xsi:nil="true"/> <ns1:selectedContractList> <ns2:selectedContract>VADCB</ns2:selectedContract> <ns2:selectedContract>PAYPAL</ns2:selectedContract> <ns2:selectedContract>AMAZONPAY</ns2:selectedContract> <ns2:selectedContract>GOOGLEPAY</ns2:selectedContract> </ns1:selectedContractList> <ns1:buyer> <ns2:title>4</ns2:title> <ns2:lastName>DO</ns2:lastName> <ns2:firstName>JO</ns2:firstName> <ns2:email>johndoe@yopmail.com</ns2:email> <ns2:walletId>W_RG1</ns2:walletId> <ns2:mobilePhone>0600000000</ns2:mobilePhone> <ns2:customerId>RG1</ns2:customerId> <ns2:legalStatus>1</ns2:legalStatus> <ns2:legalDocument>5</ns2:legalDocument> <ns2:birthDate>1980-01-20</ns2:birthDate> <ns2:fingerprintID>65w4765xf45qs4fmjslgkj354q354</ns2:fingerprintID> </ns1:buyer> <ns1:merchantName>Demo</ns1:merchantName> </ns1:doWebPaymentRequest>

2. Créer le formulaire de paiement

Pour créer un formulaire de paiement affiché lors de la validation du panier, il suffit d'insérer une balise <DIV> dans le corps de votre page web. Monext Online va se servir de cette balise pour afficher le formulaire de paiement.

Développer
title Exemple de page web..
Bloc de code language xml theme Confluence <html> <head> <script src="https://homologation-payment.cdn.payline.com/cdn/scripts/widget-min.js"></script> <link href="https://homologation-payment.cdn.payline.com/cdn/styles/widget-min.css" rel="stylesheet" /> </head> <body> <div id="PaylineWidget" data-token="the token obtained in doWebPayment Response" data-template="column" data-embeddedredirectionallowed="false" /> </body> </html>

3. Obtenir l'état du paiement

Résultat du paiement : depuis votre SI vous devez utiliser la fonction getWebPaymentDetails de l'API Web Payment pour obtenir le résultat du paiement.

Développer
title Exemple d'une demande de résultat..
Bloc de code language xml theme Confluence <ns1:getWebPaymentDetailsRequest xmlns:ns1="http://impl.ws.payline.experian.com" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <ns1:version>20</ns1:version> <ns1:token>2wkKWP3h8kdaqW78DX061544613601241</ns1:token> </ns1:getWebPaymentDetailsRequest>

Développer
title Exemple d'une réponse de résultat..
Bloc de code language xml theme Confluence <getWebPaymentDetailsResponse xmlns="http://impl.ws.payline.experian.com" xmlns:obj="http://obj.ws.payline.experian.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">    <result>       <obj:code>00000</obj:code>       <obj:shortMessage>ACCEPTED</obj:shortMessage>       <obj:longMessage>Transaction approved</obj:longMessage>     </result>     <transaction>       <obj:id>28346122024986</obj:id>       <obj:date>12/12/2018 12:20:24</obj:date>       <obj:isDuplicated>0</obj:isDuplicated>       <obj:isPossibleFraud>0</obj:isPossibleFraud>       <obj:fraudResult/>       <obj:explanation/>       <obj:threeDSecure>N</obj:threeDSecure>       <obj:score>0</obj:score>       <obj:partnerAdditionalData xsi:nil="true"/>    </transaction>      <payment>       <obj:amount>33300</obj:amount>       <obj:currency>978</obj:currency>       <obj:action>101</obj:action>       <obj:mode>CPT</obj:mode>       <obj:contractNumber>VADCB</obj:contractNumber>       <obj:differedActionDate/>       <obj:method>CB</obj:method>       <obj:cardBrand xsi:nil="true"/>    </payment>    <authorization>       <obj:number>OK</obj:number>       <obj:date>12/12/2018 12:20:24</obj:date>    </authorization>    <privateDataList/>    <paymentRecordId xsi:nil="true"/>    <authentication3DSecure>       <obj:md xsi:nil="true"/>       <obj:xid xsi:nil="true"/>       <obj:eci xsi:nil="true"/>       <obj:cavv xsi:nil="true"/>       <obj:cavvAlgorithm xsi:nil="true"/>       <obj:vadsResult xsi:nil="true"/>    </authentication3DSecure>    <card>       <obj:number>444433XXXXXX1111</obj:number>       <obj:type>CB</obj:type>       <obj:expirationDate>1220</obj:expirationDate>       <obj:token>4444SxXvCAOj1111</obj:token>    </card>    <extendedCard>       <obj:country/>       <obj:isCvd/>       <obj:bank/>       <obj:type>CB</obj:type>       <obj:network xsi:nil="true"/>    </extendedCard>    <order>       <obj:ref>REF1</obj:ref>       <obj:origin xsi:nil="true"/>       <obj:country xsi:nil="true"/>       <obj:taxes xsi:nil="true"/>       <obj:amount>10000</obj:amount>       <obj:currency>978</obj:currency>       <obj:date>12/12/2018 12:20:00</obj:date>       <obj:deliveryTime xsi:nil="true"/>       <obj:deliveryMode>1</obj:deliveryMode>       <obj:deliveryExpectedDate>16/12/2018</obj:deliveryExpectedDate>       <obj:deliveryExpectedDelay>0</obj:deliveryExpectedDelay>    </order>    <media>Computer</media>    <wallet>       <obj:walletId>W_RG1</obj:walletId>       <obj:lastName>DO</obj:lastName>       <obj:firstName>JO</obj:firstName>       <obj:email>johndoe@yopmail.com</obj:email>       <obj:shippingAddress>       <obj:name>Monext</obj:name>       <obj:street1>260, rue Claude Nicolas Ledoux</obj:street1>       <obj:street2/>       <obj:cityName>Aix-en-Provence Cedex 3</obj:cityName>       <obj:zipCode>13593</obj:zipCode>       <obj:country>FR</obj:country>       <obj:phone>0442000000</obj:phone>       </obj:shippingAddress>       <obj:card>          <obj:encryptionKeyId xsi:nil="true"/>                   <obj:encryptedData xsi:nil="true"/>          <obj:number>444433XXXXXX1111</obj:number>          <obj:type>CB</obj:type>          <obj:expirationDate>1220</obj:expirationDate>          <obj:ownerBirthdayDate/>          <obj:password/>          <obj:cardholder/>          <obj:token>4444SxOvCAOj1111</obj:token>       </obj:card>       <obj:comment/>       <obj:default>Y</obj:default>    </wallet>    <contractNumberWalletList>       <obj:contractNumberWallet>VADCB</obj:contractNumberWallet>    </contractNumberWalletList>    <contractNumber>VADCB</contractNumber> </getWebPaymentDetailsResponse>

  Vous pouvez consulter le résultat de vos transactions dans le centre administration.

Vous pouvez également consulter les autres modes d'intégrations.

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 ».

Moyen de paiement

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.

É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 maîtriser 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 décrit les tests à réaliser.
• Réaliser une transaction pilote.
• Vérifier la transaction dans le centre d’administration.

É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.