Présentation
Un kit d'intégration est une librairie logicielle (sdk) qui facilite le développement informatique que vous allez devoir réaliser pour intégrer la solution de paiement Payline dans votre site.
Vous devez consulter la documentation Comment démarrer et l'intégration Paiement Page Web pour développer votre Paiement Page Web.
Le SKD PHP est composé des éléments suivants :
- une notice d’installation du SDK de développement ;
- un descripteur composer.json pour le téléchargement via Composer de la librairie PHP qui permet d'utiliser les fonctions de l'API Payline ;
- un exemple d’application web utilisant le SDK.
Installation
Exécuter les étapes suivantes :
1. Télécharger le SDK de l'API Payline :
Si vous n'utilisez pas encore Composer, téléchargez l'exécutable composer.phar via https://getcomposer.org/download/
Déposez l'exécutable composer.phar au même niveau que le fichier composer.json inclu dans l'archive payline-php-sdk.
composer require monext/payline-sdk
En montant le fichier avec composer on trouve trois répertoires :
Le répertoire 'lib'
Il regroupe les classes qui décrivent les demandes, réponses et objets de l’API SOAP Payline.
- paylineSDK.php : Ce fichier contient la classe principale qui permet la création de messages SOAP ainsi que les autres classes spécifiques qui réalisent gèrent les demandes et réponses métier. Par exemple : doWebPayment, getWebPaymentDetails.
- lib_debug.php : C’est la librairie de debug qui permet l’affichage sous forme de tableau imbriqué du message retour de vos demandes à l’API SOAP Payline.
- v4.XX.wsdl : Le descripteur des web services Payline, à partir duquel les requêtes/réponses sont construites. Ce fichier est remplacé à chaque nouvelle release de Payline, la compatibilité ascendante est assurée.
- CONFIG.php : Ce fichier introduit dans la version V4.64.1 remplace le répertoire configuration et son contenu. Il contient les paramètres de connexion à Payline, ainsi que les paramètres (contrats, version, devise,...) affichés par défaut dans les pages d'exemple.
Le fichier CONFIG.php peut être édité directement, ou via le formulaire inclut dans la rubrique Home.
Le répertoire 'logs'
Au sein de l’archive, ce répertoire est vide. Il correspond au répertoire par défaut d’écriture des traces.
Un fichier <date>.log (<date> étant au format aaaa-mm-jj) est créé et/ou alimenté lors de chaque appel à une fonction de la librairie.
La fonction d’ajout d’une ligne dans ce fichier se nomme writeTrace. C’est une fonction publique de la classe paylineSDK, qui peut donc être réutilisée.
Fonctions
La classe paylineSDK propose une fonction correspondant à chaque web service, portant le même nom que ce dernier (doWebPayment, doAuthorization, …).
Appel
Retour
Cas particulier
Configuration du SDK
Le fonctionnement du SDK nécessite l’activation des extensions PHP suivantes sur votre serveur : php_curl, php_http, php_openssl, php_soap
MERCHANT_ID : l’identifiant de votre compte commerçant
ACCESS_KEY_REF : la référence web2token associée à votre clé d’accès
Compatibilité du SDK
Le SDK PHP est compatible avec l’environnement suivant :
- le système Windows 7 Professionnel
- le serveur Apache 2.2.22
- la version PHP : voir le fichier README.md sur github
Intégration
Veuillez consulter la documentation Comment démarrer et l'intégration Paiement Page Web pour développer votre Paiement Page Web.
Lors de l'intégration, veuillez bien à nommer les balises comme indiqué dans le kit. Elles peuvent être différentes de l' API Payline :
Pour la balise <authentication3DSecure>, il faut appeler <3DSecure>
- Le commerçant doit valoriser le tableau en remplaçant ['authentication3DSecure'] par ['3DSecure']
Pour la balise <selectedContractList> s'appelle <contracts>
- Le commerçant doit valoriser le tableau en remplaçant [' selectedContractList '] par ['contracts']
Exemple d'utilisation de l'initialisation de paiement en mode page web :
Exemple d'utilisation d'une demande d'autorisation de paiement en mode direct
Pages associées