Contenu
Next Step
Payline is a secure payment solution. Composed of two distinct environments but ISO between them :
The platform allows to process payments. It is connected to many new ways of payment. Their integration is greatly simplified by using the Payline solution.
Here is how an integration takes place:
Step 1: Implementation of the payment solution, in accordance with the specifications.
Step 2: Validation of the integration and signature of the acceptance report.
Step 3: Monitoring transaction flows to detect a potential problem and fix it quickly.
Each integration lot must respect the 3 integration steps.
Payline uses web services to communicate with the merchant server. In a web payment, the doWebPayment web service is used. It triggers the opening of a payment session. After checking the data, Payline sends: 00000 if OK or an error code if KO.
Also in the return frame is the token associated with the transaction and the redirect URL if the redirection mode is used. Using the token, the widget is initialized and the shopper can proceed to the payment. At the end of the payment, the shopper is redirected to the "Return URL" provided in the doWebPayment call.
The call to the web service getWebPaymentDetail is triggered by the return on the "Return URL" or by the notification. In the getWebPaymentDetailResponse, the result and all the details of the transaction are sent. Then the payment session is closed, the payment made, the merchant can display the payment confirmation on his page.
Example transaction :
For a 1000€ travel, the buyer has to pay 30% of the total amount of down payment the day of booking and the rest 30 days before the trip.
The first payment (30% of the total amount) :
Cancel URL : The cancel URL is used when a transaction is canceled.
An example of a web application using the SDK;
A library of functions that links the functions of the Payline API;
An SDK configuration file;
An installation instruction of the integration SDK;
The WSDL file describing the web services offered by Payline.
Every web service Payline is composed of two files :
The SDKPayline class use SDKPayline.dll in the Bin repertory. This class describe a function for each web service using the same name : doWebPayment, do Authorisation. You have to update the file with the PaylineSDK_4.52.dll.
The parameter pass is described in each sample page of the SDK.
Once the SDK is install in the server the Resource.resx file as to be filled with the following configuration settings
Mobile
Tablette
Desktop
Always keep the original .css file in case of update
Cancel button : The cancel button will call the cancel url passed in the DoWebPayment Request.
Please download these files and put them in a server (local or not): PLEASE UPDATE THE URLS IN THE DOWEBPAYMENT REQUEST
You can now try the widget with a fresh token (a session expires after 15 minutes)
Get a fresh token.
Call the testpayment.html page :
In the form past the token :
The test.php page is called and the widget initialized with the token. you can analyze the code of the test.php page :
Enter your test card information or click on "CANCEL PAYMENT" to trigger the cancel function :
If you have entered your card data you will be redirected on the "Return URL" from the DoWebPayment REQUEST :
If you have click on the CANCEL PAYMENT button, you will be redirected on the "CANCEL URL" from the DoWebPayment REQUEST.