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 Sogenactif solution.

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

• Functional presentation
• ../en/functionality-set-up.htmlFunctionality set-up guide

Your customers' payment details must be stored in Sogenactif 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 Sogenactif. 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, ...);

For any question or request for technical assistance, you can contact the usual Sogenactif support on 0 825 090 095 (0.15€/min + call charge - rate as of 02/11/2022) from Monday to Friday, from 9am to 7pm, excluding public holidays, or write to supportsogenactif@worldline.com specifying your VAD or MID contract number for a more efficient handling of your request.

As Sogenactif 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 Sogenactif Paypage, the total amount of the order is indicated as well as the amount of the first transaction which is 0.

For Sogenactif Office Serveur, 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 Sogenactif Paypage,the request parameters are identical to those used on Sogenactif Office Serveur.

Depending on the response returned by Sogenactif on Sogenactif Paypage or on Sogenactif Office Serveur, 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 Sogenactif. 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 Sogenactif that meet your needs (see chapter Choice of connectors Sogenactif, you need to integrate the connectors to connect your website to Sogenactif and follow the indications of the implementation part.

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

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

Your shop is not registered on Sogenactif.

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

Your shop is already registered with Sogenactif.

If your shop is already registered with Sogenactif, you must check with SG to ensure to have access to Sogenactif Paypage or Sogenactif Office Serveur.

You must change the URL to connect to the Sogenactif 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.