Présentation du SDK

.NET

Composition du

SDK

Le kit SDK  .NET est composé des éléments suivants :

• un exemple d'application web utilisant le kit SDK ;
• une librairie de fonctions qui permet d'utiliser les fonctions de l'API Payline ;
• un fichier de configuration du kit SDK ;
• une notice d'installation du kit SDK d'intégration ;
• le fichier WSDL décrivant les Services Web proposés par Payline.

Télécharger le SDK (4.8.5) de l'API Payline version 30 de la release 4.70 : 

• https://www.nuget.org/packages/Monext.Payline.DotNetSDK/
• https://github.com/PaylineByMonext/payline-dot-net-sdk

Structure et Fonctions

Un exemple d'application web

Chaque web service Payline se décline sous la forme de deux fichiers :

• un fichier ASPX.CS contenant le formulaire de présentation ;
• un fichier ASPX qui récupère les données transmises par l'utilisateur via le formulaire. Le code C# réalise l'appel au Web Service souhaité.

Par exemple, la fonctionnalité « doWebPayment » qui permet la réalisation d'un paiement Web via le kitSDK, se traduit par la présence des deux fichiers suivant :

• doWebPaymentForm.aspx Ce fichier simule la page récapitulatif de la commande de votre client. Elle constitue l'étape 0 dans le processus de paiement web. Vous pouvez modifier les valeurs Amount, Currency et OrderRef pour réaliser des paiements tests.
• doWebPayment.aspx.cs Ce fichier contient le code ASP qui récupère les informations transmises par le formulaire HTML et utilise la librairie pour initialiser une demande de paiement web.

Une librairie

La classe SDKPayline, correspondant au fichier SDKPayline.dll stockée sous le répertoire Bin du kitSDK, propose une fonction correspondant à chaque web service, portant le même nom que ce dernier (doWebPayment, doAuthorization, …).
Le passage de paramètre entre votre boutique et ces fonctions est expliqué au travers des pages d'exemple contenues dans le kitSDK.

Un répertoire 3D Secure

Le répertoire 3DSecure dans le kit SDK contient le script qui traite le callback lors d'une transacation transaction 3D Secure en mode direct. C'est le lien vers ce fichier qu'il faut mettre dans le fichier de configuration à la clé TERM_URL. Vous trouverez plus de détails dans le document d'intégration du 3D Secure en mode direct.

Configuration

du SDK

Une fois le kit SDK décompressé sur votre serveur, vous devez associer des valeurs aux paramètres de configuration déclarés dans le fichier Resource.resx.

MERCHANT_ID : l'identifiant de votre compte commerçant
ACCESS_KEY : la clé d'accès associé à votre compte commerçant
PROXY_HOST : l'URL de votre proxy Internet
PROXY_PORT : le port de communication de votre proxy Internet
PROXY_LOGIN : l'identifiant utilisateur requis par votre proxy Internet
PROXY_PASSWORD : le mot de passe utilisateur requis par de votre proxy Internet
PROD : indicateur qui permet de basculer facilement de l'environnement d'homologation à la production.
PAYMENT_CURRENCY : le code ISO de la devise à utiliser par défaut pour le paiement
ORDER_CURRENCY : le code ISO de la devise à utiliser par défaut pour la commande
SECURITY_MODE : le code du mode de sécurité à utiliser par défaut
LANGUAGE_CODE : le code ISO de la langue à faire afficher par défaut
PAYMENT_ACTION : le code de la méthode de paiement à utiliser par défaut
PAYMENT_MODE : le mode de paiement à utiliser par défaut
CANCEL_URL : l'URL d'annulation utilisée lorsque le paiement a été refusé ou que votre client a annulé le paiement
NOTIFICATION_URL : l'URL de notification utilisée lorsque Payline vous notifie d'un paiement effectué
RETURN_URL : l'URL de retour utilisée lorsque le paiement a été accepté
CUSTOM_PAYMENT_TEMPLATE_URL : l'URL du template dynamique à appliquer aux pages web de paiement
CUSTOM_PAYMENT_PAGE_CODE : le code de personnalisation des pages de paiement Payline à utiliser par défaut.
CONTRACT_NUMBER : le numéro de contrat qui identifie votre point de vente et votre moyen de paiement par défaut,
CONTRACT_NUMBER_LIST : la liste des numéros de contrat à faire afficher si vous en possédez plusieurs. Sinon votre numéro de contrat unique.
SECOND_CONTRACT_NUMBER_LIST : la liste des numéros de contrat à faire afficher lorsque la première tentative de paiement est un échec.
TERM_URL : URL de callback pour le retour de l'ACS lors des transactions 3D Secure en mode direct.

Compatibilité

du SDK

Le kit SDK .NET est testé avec l'environnement suivant :
Le kit SDK Payline .NET 2.0 est compatible avec l'environnement suivant:

• IIS 5.1, .NET 4 avec système Windows XP Professional SP3.
• IIS 7.5, .NET 4 avec système Windows 7 SP1.
• IIS 7.5, .NET 4 avec système Windows Server 2008 R2.

Pour tester l'application exemple

du SDK

Mise en route

Créer un site ou un répertoire virtuel sous IIS.
Décompresser le kit SDK .NET 2.2
Sélectionner le répertoire du kit SDK puis connectez-vous avec un compte administrateur local.

Cartes de tests

Dates d'expiration : une date valide à venir exemple 12/2018
Cryptogramme : un chiffre sur 3 positions. Exemple 123
Le mot de passe 3D Secure est secret3

Pages associées