WL Sips is a secure multi-channel e-commerce payment solution that complies with the PCI DSS standard. It allows you to accept and manage payment transactions by taking into account business rules related to your activity (payment on despatch, deferred payment, recurring payment, payment in instalments, etc.).
The purpose of this document is to explain how to switch from Sips Payment 1.0 to the Sips Paypage 2.0 as part of a simplified migration.
Topics not covered in this document:
- This document shows only the migration to the Sips Paypage 2.0 POST which is a connector recommended on Sips Paypage 2.0. If you want to use the JSON version, please refer to the Sips Paypage JSON document.
Who does this document target?
This document is intended for merchants having the WL Sips 1.0 offer . It is intended to facilitate the migration to WL Sips 2.0.
For full details on the Sips Paypage 2.0 payment pages use, please refer to the WLSIPS.306 UG Sips Paypage POST document (recommended connector).
Contacting the support
For any technical question or request for assistance, our services are available:
- by telephone at: +33 (0) 811 10 70 33
- by e-mail: email@example.com
In order to facilitate the processing of your requests, please provide your merchantId (15-digit number).
The Sips Paypage 2.0 assets
The Sips Paypage 2.0 allows to no longer store the files specific to the call of the payment pages on your server.
Also, the choice of payment method can be made on your merchant server (by specifying the payment method during the call) or payment server-side Sips Paypage 2.0.
Finally, with the Sips Paypage 2.0 POST, only a form in POST mode will be sent to Sips Paypage 2.0 servers to make the payment process. The redirection is made automatically by the payment server to the page for entering the payment method details.
What does changes in WL Sips 2.0?
For the payment part:
- the new URL for the payment pages part
- the choice management of the payment method is deported to WL Sips
- the WL Sips certificate is replaced by a secret key
You no longer install any files on your device, regardless of the choosen WL Sips 2.0 interface.
What you need to do?
- Decide which Sips Paypage 2.0 connector to use (POST, JSON).
- Set up your payment requests by securing the new secret key.
- Use the customer recipe environment to test your Sips Paypage 2.0 applications with an available login ID.
- Delete references to Sips Payment 1.0 on your website (certificate, settings files, executable files).
Choosing the Sips Paypage 2.0 connector
This document shows only the POST connector (request sent to the WL Sips server in POST mode).
If you want the payment server calls to be made in machine-to-machine mode with JSON technology, please refer to the Sips Paypage POST integration guide document for setting up requests in this mode.
Customisation of the recovery in payment response
The automatic and manual responses will be adapted based upon the versions presented on Sips Payment 1.0.
The sample response files given in the sample directory are named call_response.php and call_autoresponse.php.
Contrary to the Sips Payment 1.0 where the data was sent to the response.exe executable contained in the bin directory, it will now be necessary to retrieve the field named Data containing the response data and check the Seal field containing the received message fingerprint.
Response basic data recovery
The new form must load the recovery of your data allowing to make the payment request, for example:
//Recupération des donnees de la reponse $Data=htmlspecialchars($_POST[“Data”]); $Seal=htmlspecialchars($_POST[“Seal”]); //Separation de tous les champs $tableau = explode ("|", $Data);
SEAL field calculation
Then calculating the message fingerprint using the hash of the Data field by your secret key:
It will then be necessary to verify that the Seal corresponds to the Seal received in the request.
Test on the simulation environment
Integrate the 2.0 connectors and test with simulation data
A basic knowledge of the standards for today’s web programming languages, such as Java, PHP or .Net, is required to implement the connection.
You will choose the connector you want to integrate. This choice is made according to your need. For example, if you are currently using Sips Payment 1.0, you can choose the Sips Paypage connector.
Your integration will necessarily be with a
transaction_id generated on your side. This
configuration is mandatory so as to:
- allow your shop to run with 1.0 APIs and 2.0 connectors
- keep the formats of 1.0 reports
|Data||Transaction creation via Sips Paypage|
|transactionId provided by you||Standard processing|
|Absent transactionId||Reject code = 12|
|transactionReference provided by you||Reject code = 12|
|Additional reference generated by WL Sips||transactionReference|
The online documentation site provides you with dedicated documents for each connector in the 'Developers' section. We invite you to refer to the documentation tree structure available in Appendix 2 herein for reference documents. You can use the online documentation site for all additional documentation.
After integration and to perform your tests, simulation data is available in the dedicated documentation of the connectors you integrate.
For the Sips Paypage connector, the simulation data
consists of a URL, a
a dedicated secret key, which will allow you to do some tests without
impacting your current workflow.
|Your ID (merchantId)||002001000000003|
|Key version (keyVersion)||1|
The DEBUG mode no longer exists, but during the test in a recipe environment, each error is displayed clearly and thus makes it possible to better prepare the payment requests.
Removing references to Sips Payment 1.0
When installing Sips Payment 1.0, the following tree structure is created on the server:
Once the Sips Paypage 2.0 files have nothing more to do with this tree structure, you can completely delete the present files.