Vous trouverez dans ce manuel comment réaliser des transactions avec Payline en utilisant notre API.
Audience
Ce manuel s'adresse aux développeurs qui intègre la solution de paiement Payline dans les systèmes marchands.
Conformité PCI
Vous devez être conforme au standard de sécurité des données pour l’industrie des cartes de paiement » en suivant la norme PCI-DSS « Payment Card Industry Data Security Standard ». Le programme PCI DSS vise à améliorer la sécurité des systèmes d’information et demande donc aux acteurs de mettre en place et respecter certaines bonnes pratiques.
PCI DSS s’adresse à tous les acteurs qui capturent, transportent, stockent et/ou traitent des données de cartes bancaires. Les commerçants de proximité, les marchands sur internet, les réseaux de transport, les centres d’appels, les banques, les émetteurs de cartes font partie des acteurs concernés par PCI DSS.
Le processus de certification nécessite un nouvel audit chaque année. Payline est certifiée annuellement depuis 2008.
En fonction du mode d'intégration Payline choisi par le e-commerçant, celui-ci devra complété un questionnaire d'auto-évaluation PCI DSS particulier (SAQ ou Self Assessment Questionnary).
Vos retours sont les bienvenues
Nous tenons à vous fournir une documentation claire, concise et complète.
Nous nous engageons à l'améliorer continuellement et la rendre accessible et compréhensible. Nous apprécions vos remarques et commentaires. N'hésitez pas à nous en faire part!
Authentification
Version de l'API
Des nouvelles de version de Payline sont livrées tout le long de l'année, les services et balises évoluent avec le numéro de version tout en respectant une compatibilité ascendante : voir le lien Historique de version de l'API.
Communication
Endpoint
L’API Payline
L’API Payline fournit l’accès aux différentes fonctionnalités de la solution de paiement Payline. Elle est basée sur des composants « Web Service » standards, qui incluent le protocole SOAP et les langages de définition WSDL et XSD. Ces standards sont supportés par une large gamme d’outils de développement sur des plateformes multiples.
L’utilisation du client Java Axis2 avec XMLBeans est très fortement préconisé car il permet de garantir une continuité de service en cas d'évolution des Web Services. L’utilisation d’un client Java Axis2 est déconseillée avec ADB.
L’API Payline recouvre l’intégralité des fonctions disponible sur la solution de paiement Payline.
Elles sont décrites en fonction du mode d’intégration choisit par le commerçant, et il est tout à fait possible d’intégrer les 3 modes d’intégrations sur votre site e-commerce.
Préconisation : éviter les caractères avec accent et les caractères spéciaux (",#,&,(,),*,+,,,-,.,/,:,;,<,=,>,_,|, ,^,\,\\,',!,\",%,$,?,@,[,],`,{,},~)
Vous pouvez trouver les listes des services et codes retour ci-desous :
Gestion des timeout
Le temps maximum de réponse de Payline est de 30 secondes.
Dans le cas où vous n’obtenez pas de réponse, vous pouvez réaliser une nouvelle demande. Payline contrôle vos demandes et identifie celles qui sont identiques (doublon). La réponse renvoyée est la réponse de la première demande.