WL SIPS DOCS

This document is intended to help you implement the multiple payments upon shipping.

The purpose is to present the functionalities related to the multiple payments upon shipping and to explain how to implement them with the Worldline Sips solution.

To get an overview of the solution Worldline Sips, we advise you to consult the following documents:

• Functional presentation
• ../en/WLSIPS.004-GD-Functionality-set-up-guide.htmlFunctionality set-up guide

Your customers' payment details must be stored in Worldline Sips to allow you to make multiple payments upon shipping.

You have some points to process before starting:

• to be in compliance with the GDPR, you have to fill in your internal personal data processing register, specifying that banking data are maintained by Worldline Sips. For more information on the GDPR, please refer to our documentation on information systems security;
• inform your customers about the storage of their details and the terms of multiple payments upon shipping (amounts, number of due dates, ...);
• verify with your acquirer that your contract supports recurring payments.

As Worldline Sips As it offers several interfaces to process multiple payments upon shipping, it is necessary to analyse your business needs to choose the most suitable connectors for your situation.

multiple payments upon shipping is divided into two types of transactions:

• Order taking / first delivery: for this transaction your customer is present. He can choose his payment method, authenticate himself (in accordance with DSP2 regulations) and validate the payment of his order. This type of transaction is called CIT or "Client Initiated Transaction".
• Subsequent deliveryies: for these transactions, your customer is not present. These transactions will be initiated by you and carried out each time a new delivery is made. They are called MIT or "Merchant Initiated Transaction".

The table below summarises the available interfaces according to the type of transaction.

Depending on how you process the different deliveries, the data to be kept varies:

During the order placement phase, your customer will have to authenticate himself with 3-D Secure. Once authenticated, an authorisation request for the amount of the first delivery must be made. We assume that the first shipment of goods will take place before the end of the authorization period (6 days). If the first shipment takes place more than 6 days after the order has been placed, please refer to the section "Special case of the first shipment separated from the order".

In some cases, you may not know the first shipment date of your customer's order. For shipments on a date greater than the validity of the authorisation (generally 6 days) or for shipments on an unknown date, a particular behaviour must be put in place.

For this type of placement, the amount of the first delivery must be 0. An enquiry will then be made instead of an authorisation on the amount of the first shipment. Your customer will therefore not be charged when the order is placed, but when the first shipment is made.

Once the order has been placed with an amount of 0, you will have a pivotal transaction that can be used for all future shipments of the order. In the case of a payment with the CB payment method, this behaviour is compatible with the payment guarantee eligible up to 30 days.

On Sips Paypage, the total amount of the order is indicated as well as the amount of the first transaction which is 0.

For Sips Office, the cardCheckEnrollment and walletCheckEnrollment methods allow you to initiate a multiple payments upon shipping. In these requests, you will need to fill in the parameters as shown in the table herebelow.

For Sips Paypage,the request parameters are identical to those used on Sips Office.

Depending on the response returned by Worldline Sips on Sips Paypage or on Sips Office, you determine the status of the transaction.

The order placement fields are as follows:

When shipping goods, you will want to invoice your customer. To do this, you will need to make a new transaction on Worldline Sips. For this transaction, your customer will not need to be present (MIT).

To invoice your customer for a new delivery of goods, you have several options:

• The duplicate operation
• Creating a new transaction

Here is an example of multiple payments upon shipping with a 1st shipment within 6 days:

July 28th 2021 day of the order (CIT) with an authentication of the total amount of the order, i.e. EUR 500 and an authorisation request for the amount of the first shipment, i.e. EUR 100. The duration of the authorisation request runs from 28 July to 3 August (6 days). On August 2nd 2021, i.e. D+4, dispatch of the 1st package resulting in the settlement with the 3DS data of the CIT for €100. On August 15th 2021, i.e. D+17, dispatch of the 2nd package, triggering a MIT (MIT1) resulting in a chained authorisation request with the CIT and a remittance in 3DS data for an amount of 400 euros.

Connectors:

Request parameters :

Here is an example of multiple payments upon shipping with a 1st shipment more than 6 days away:

July 28th 2021 day of the order (CIT) with an authentication of the total amount of the order, i.e. EUR 500 and a card information request triggered by an amount of EUR 0. The duration of the authorisation request runs from 28 July to 3 August (6 days). On August 2nd 2021, i.e. D+8, dispatch of the 1st package triggering a MIT (MIT1) resulting in a chained authorisation request with the CIT and a remittance in 3DS data for an amount of 100 euros. On August 15th 2021, i.e. D+17, dispatch of the 2nd package, triggering a MIT (MIT2) resulting in a chained authorisation request with the CIT and a remittance in 3DS data for an amount of 400 euros.

Connectors :

Request parameters:

When you have chosen the interfaces Worldline Sips that meet your needs (see chapter Choice of connectors Worldline Sips, you need to integrate the connectors to connect your website to Worldline Sips and follow the indications of the implementation part.

Your shop must be set up in Worldline Sips to accept multiple payments upon shipping. You should ask Worldline to activate this service on your shop if you have not already done so.

Once you have implemented the Worldline Sips connectors, you can do some tests to validate your integration.

Your shop is not registered on Worldline Sips.

If your shop has not yet been registered, you must fill in the registration form and return it to Worldline.

Your shop is already registered with Worldline Sips.

If your shop is already registered with Worldline Sips, you must check with Worldline to ensure to have access to Sips Paypage or Sips Office.

You must change the URL to connect to the Worldline Sips production server using the credentials you received when registering merchantId, secretKey, and keyVersion.

If you want to customise your payment pages, please follow the procedure described in the Custompages documentation.