Integrations¶

Whether you are a business or a payments service provider, a beginning of any Integration starts with a sets requirements on the payment processes needed. This description begins with the requirements of a typical online merchant and introduce other examples as we look at specific features that the Worldline platform offers to solve specific but common requirements of online sales.

Client Side Integrations	Server Side Integrations
Payment Page	Payment REST API
Device REST API	Web Service
Client Side Encryption	Notification Service
	Batch Interface

See Tech Guides for a deeper overview of the use of the integration options.

Payment Page¶

The Hosted Payment Page Integration is a service offered by Worldline where the Payment web page presented to the shopper to type in their payment details is hosted from Worldline and not from the merchant website. This has a number of advantages for the merchant.

The Payment Page is hosted by Worldline so the merchant programmers do not need to build (or maintain) software specific to each payment method. In fact the Payment Page can display a list of payment methods that allows the shopper or web shop customer to select their preferred payment method, then input their details and click the buy button. The Worldline Payment Page also provides automatic support for displaying in multiple languages. Any credit card data is entered into software and systems run exclusively by Worldline taking this data out of PCI scope for the merchant systems and networks. The Worldline Payment Page is highly customizable, allowing merchants to maintain their Company Look and Feel onto this page to simplify the customer journey.

See Payment Page Integration for details.

Device REST API¶

Using the Device REST API, a merchant can combine payment form with checkout, subscriptions or sign up for services. The Worldline client side Javascript SDK provides convenient methods for executing the calls to Worldline. This integration supports

Tokenization
Payments
Stored Users (e.g. Visa Checkout)
Redirect Payments, e-Wallets and Internet Bank Payments

See Device REST API integration

Payment REST API¶

Worldline provides several REST APIs. The Payment REST API provides a predictable resource oriented API that accepts and returns JSON bodies, and uses standard HTTP response codes, authentication and verbs. The API supports:

Server integrations
Processing of Cards, IBP, Redirect and eWallet payments, as well as EFT.
Payment Management functions such as Refund or Capture where supported by the payment method.
These Integration Methods can be used independently or in combination depending on the merchant business requirements. Payment management can also be carried out via the Online Merchant Portal.

See Payment REST API for further information.

Web Service¶

The Web Service is an API Integration to the Worldline platform giving access to all the payment service functionality. This includes:

Support for direct submission of payment requests where the payment details can be collected by the merchant. This includes card payments and direct debits.
Creation of the appropriate Redirection URL for payment methods requiring shopper authorization input such as Online Banking, Wallets, and of course 3D Secure.
Payment Management functions such as Refund or Capture where supported by the payment method.
These Integration Methods can be used independently or in combination depending on the merchant business requirements. Payment management can also be carried out via the Online Merchant Portal.

See Web Service integration for more information.

Client Side Encryption¶

The Worldline Client Side Encryption increases the security and reduces the PCI compliance scope for the Merchant, as sensitive Card Information is encrypted in the end users Web Browser, and is then sent encrypted to the Worldline Web Service via the Merchants web servers. The Merchants Web Servers will no longer need to manage the sensitive unencrypted Card Information in their systems.

Notification Service¶

Worldline also offers a Notification Service by which a merchant can subscribe to updates on a payment order, as an addition to the Integration Options.

If configured, the Notification Service allows the Worldline platform to send messages to the merchant system, informing on changes in the status of the payments submitted by the merchant. It is recommended to enable this service if a merchant uses any payment methods requiring redirection to a website external to Worldline, such as Online Banking. These methods usually complete by the shopper being redirected back to the merchant web shop. In the case where the shopper activity obstructs that redirect back, the merchant will not receive the payment result. In such cases the Notification Service ensures an alternative confirmation for successful payments. This simplifies the processing of such situations in the web shop, allowing more sales to be completed.

See Merchant Notification Service integration for more information

Batch Interface¶

Large scale integrations

Although not typically used as a primary Integration method, Worldline also offers a Batch Interface that can offer significant performance advantages for merchant business processes involving large numbers of payment requests or updates needing to be submitted together. These requests can be placed into a file, encrypted for secure transmission and uploaded to the Worldline platform. The responses will also be provided in file form for downloading via the same access and processing at the merchant. This Interface can be used for example where large numbers of recurring transactions or payment captures need to be submitted.