Ingenico by Worldline Integration – Duve

Duve offers integration to Ingenico by Worldline payment provider to enable guest billing, upsells and pre-authorization during the guest experience journey.

Duve Supported Payment types:

Guest Billing
Additional Hold
Upsells

Capabilities:

Preauthorization
- Note: Duve does not support a PreAuthorization of '0 euro' which would be used to take a token on the card.
Direct Charges

Overview

When connecting Worldline to your Duve account, a host will be able to track direct charges and preauthorizations on the guest's cards.

For Upsells that require Approval, a Host can approve directly from the platform. Approval confirmation from Worldline can take up to 24 hours to confirm that the charge was successful. Until an upsell is approved, a hold is placed on the card for the amount requested. The duration of the total hold time on the card is dependent on the contract with Worldline.

How to Set it Up?

Retrieve Credentials from Ingenico

Go to your Ingenico account and login here.

PSPID: To get your PSPID, go to Configuration>Password>PSPID. Enter your PSPID as the Merchant ID

To get your API key, go to Configuration>Technical Information>API Settings and the API Key is listed under ‘Key’. Add the Key under the API Key ID field in Duve

To retrieve your Secret API Key, click generate Webhooks Secret API Key will be generated -

Setup in Duve

To connect your Worldline account to Duve, go to Settings>Billing and scroll down until you see the field to Enable Credit card Payment:

Click on Worldline and enter the following fields:

Add your PSPID to the ‘Merchant ID’ field*
Add your Key to the ‘API Key ID’ field*
Add your SECRET API KEY to ‘SECRET API KEY’ field*
Add your Company Name to ‘Company Name’ field*

*required

Webhooks Settings for the Worldline Account

Once you have entered all the required fields, click Connect in Duve.

Once you add the items to connect in Duve, copy the webhook URL on the page. If the account is valid, you will see the webhook URL like so:

Then, go back to Worldline, go to Configuration>Technical Information>Ingenico Direct Settings and generate Webhooks API Key.

Then paste the webhook URL in the Endpoint URLs section and Save.

*You must have a value for Webhooks Key in the field in order to save the Endpoint URL from Duve.

Once it is saved successfully, you're Done! Your Worldline account is now fully integrated to Duve.

The Guest Experience

The Payment methods listed under Payment Details are the payment methods supported by your Worldline Account.

Operations:

To view the transactions in your Ingenico account, go to Operations > View Transactions. Each transaction will have its own page but in the main list you will see the most recent status. When you enter the transaction, you will see the Authorization Logs at the bottom.

Merchant Reference Number is in the URL of the Orders page

PMS External ID is sent to the Merchant Parameters section of each transaction

Screenshot 2023-10-12 at 2.00.38 PM.png

Duve Order page:

Order logs in Duve on the Upsell page will match the Authorization Logs in Worldline.

Refund Request Sent means that Refund is pending. If you refresh the page you will see the order update log.

Logs:

'Capture Request' sent indicates when the Host approved the upsell

'Request Approved' indicates when Duve received confirmation from Worldline that the amount was successfully captured.

If an order is approved multiple times, an 'Order updated' error will show in the logs. Screenshot 2025-03-17 at 12.00.20 PM.png

Token

Duve will save a token on the credit card for Additional Hold/PreAuthorization Payments.

Troubleshooting

If the iFrame does not close, your Webhook URL from Duve is not set properly on your Worldline account.