Wix

Supported integration & payment methods

Offers the following integration methods on our platform:

Offers the following payment methods on our platform:
Alipay+
American Express
Apple Pay
Bancontact
Bank Transfer by Worldline
Bizum
BLIK
Cartes Bancaires
Cetelem 3x/4x (Installments)
Cofidis 3x/4x (Installments)
Dankort
Diners Club
Discover
EPS
Google Pay
iDEAL
JCB
Linxo Connect
Maestro
Mastercard
MB Way
Multibanco
OneyBrandedGiftCard
Paypal
Pledg
PostFinance Pay
Przelewy24
SEPA Direct Debit
TWINT
UPI - UnionPay International
Visa
WeChat Pay
Wero

Getting started

The first step to use the plugin is the installation process. Before you proceed, make sure your infrastructure meets these system requirements:

Item	Description
Direct credentials	Active live account on our platform. API key/secret.
Wix	A Wix Store with an Active eCommerce Subscription: To use our plugin and accept payments, ensure your Wix store has an active eCommerce plan. This activates Wix's payment processing capabilities.
PCI compliancy	SAQ A The plugin’s in-built features ensure this security level, but you still need to get the certificate from your acquirer.

Installation

Follow these steps to install the plugin: 

1. Log in to your Wix account. Access the specific Wix store where you wish to install the plugin.
2. Go to Settings > Finance > Payments > Accept payments. Scroll down and click on "See more Payment Options".
3. Go to Third-Party Credit/Debit Card Providers. Click on "See Options" and look up "Worldline".
4. Go to Connect the Plugin. Click on "Connect" next to the "Worldline" plugin listing to begin the installation process.

Configuration

After the installation, you need to configure the plugin to link your store to our platform.

Though our descriptions may mark certain fields as "optional," the Wix configuration dashboard could still require input for these fields before you can save your settings. If a field does not apply to your setup, such as the "HTML template ID" field, enter a random value to move forward.

Basic configuration

Set up the mandatory settings for your Wix store to communicate and process payments with your account on our platform. 

Log in to your Wix account. Go to Settings > Finance > Payments > Accept payments. Access the "Worldline GoPay connector" to configure the following settings: 

Property	Description/Actions
Merchant ID	Enter your account from our platform that you want to use for transaction processing.
Payment API Key	Enter the API Key of your account. Read our dedicated guide to learn how to generate one.
Payment API Secret	Enter the API Secret of your account. Read our dedicated guide to learn how to generate one.
Webhook Key	Enter the Webhook Key of your account. Read our dedicated guide to learn how to generate one.
Webhook Secret	Enter the Webhook Secret of your account. Read our dedicated guide to learn how to generate one.

Optional plugins settings

The following settings are optional, allowing you to customise your customers' payment experience.  

3D Secure (3DS)

Fine-tune 3-D Secure settings for enhanced security, fraud prevention and specific use cases. 

By default, all 3DS checkbox fields in the Wix configuration dashboard are unchecked, activating 3-D Secure without specific preferences applied. Some combinations of these fields might not influence the configuration due to dashboard limitations.

Property	Description/Actions
3DSecure - Disable 3DS	(Un)check to (de)activate the 3-D Secure authentication process for payments. We strongly recommend unchecking as 3-D Secure is mandatory in some markets. This will also ensure liability shift for transactions with successful 3-D Secure authentication. If you check this setting and choose to process non 3-D Secure transactions you may not benefit from liability shift and may be held liable.
3DSecure - Enable mandatory 3DS	Only applicable if "3DSecure - Disable 3DS" is unchecked. Check to ensure that 3-D Secure is always required for all applicable card transactions, offering the highest level of security.
3DSecure - Enable exemptions	Only applicable if "3DSecure - Disable 3DS" is unchecked. Check to request exemptions from 3-D Secure for specific transactions based on your predefined amount threshold. Mind that if your customer's issuer does not grant the exemption, the standard 3-D Secure authentication process will be rolled out.
3DSecure - Exemption type	Only applicable if "3DSecure - Enable exemptions" is checked. Define the type of 3-D Secure exemption your wish to apply. Possible values:  "Low value" (for amounts lower than 30€) "Transaction Risk Analysis" (for transactions you consider low risk)
3DSecure - Exemption amount	Only applicable if "3DSecure - Enable exemptions" is checked. Define the amount threshold to request 3-D Secure exemption. Depending on the type of exemption request, differences apply:  "Low value": Between 0.01 and 30 €.  Transaction Risk Analysis": Between 0.01 and 100€.

Customer Checkout Experience 

Customise the look and feel of the Hosted Checkout Page to your corporate identity. 

Property	Description/Actions
Checkout experience - HTML template ID	Enter the file name of your template to adapt our payment page to the look and feel of your shop. To learn how to create templates, see our dedicated chapters in the Hosted Checkout Page guide.
Checkout experience - Allowed number of payment attempts	Define the number of retry attempts for unsuccessful payments on the Hosted Checkout Page, allowing you to mitigate fraud, reducing your transaction costs and optimising your customers' payment journey (as they can try for another payment method instead of restarting the checkout process).
Checkout experience - Enable group credit cards	Check to group all credit card payment methods to one group "Cards" on the Hosted Checkout Page, adding some clarity to the payment selection screen.
Checkout experience - Disable sending of basket details	Check this box to prevent detailed shopping cart item information (basket data) from being sent to Worldline. Mind that several payment methods require this information for processing or fraud prevention effectively. Disabling it may lead to challenges with payment methods that depend on this data.

Payment Method Specific

Adapt selected payment methods to your preferences.

Property	Description/Actions
Payment method - Bank transfer by Worldline - Mode	Define whether you want to process instant payment only for Bank transfer by Worldline.
Payment method - SEPA Direct Debit - Recurrence type	Define whether a SEPA Direct Debit payment is a one-off transaction, or the first in a series of recurring payments.
Payment method - SEPA Direct Debit - Signature type	Define the type of signature is required for a SEPA Direct Debit payment.

Turning Off & Disconnecting

You can manage the plugin status in two ways: temporarily disable it or remove it permanently.

To do either, follow these steps: 

1. Log in to your Wix account. Go to Settings > Finance > Payments > Accept payments.
2. Look up the "Worldline" plugin. Click on "Manage" next to it.

Option 1: Temporary disable the plugin

Toggle the switch "Accepting payments" to OFF. A message appears, stating "This means you will no longer accept Worldline payments on your site. Are you sure you want to turn off Worldline?". Confirm your choice to continue. 

With the toggle OFF

• Your customers cannot select Worldline on our checkout page anymore, so no redirection to the Hosted Checkout Page will take place. 
• You cannot perform maintenance operations (i.e. refunds) via Wix anymore. 
• Your configuration settings as described above will remain intact. 

You can reactivate the plugin anytime by toggling the switch to ON anytime. 

Option 2: Permanent deactivation of the plugin

Click the "Disconnect Worldline" button at the bottom of the page. 

By doing so

• Your customers cannot select Worldline on our checkout page anymore, so no redirection to the Hosted Checkout Page will take place. 
• You cannot perform maintenance operations (i.e. refunds) via Wix anymore. 
• Your configuration settings  as described above are permanently deleted. 

To use the Worldline connector at a later point, you have to re-install/re-configure the plugin from scratch as described above.

Manage payments

We have designed the plugin to follow-up on your orders automatically and autonomously, freeing you from the administration involved. Follow the instructions below to effectively use the app and ensure a smooth payment flow.

Look up transactions

For each successfully processed transaction, a corresponding order is created in Wix. 

To look up an order, follow these steps:

1. Log in to your Wix account. In the dashboard, go to Sales > Orders. Click on the order to open its detailed view.
2. Go to the "Payment info" section and expand the "customer paid" area.
3. Look up the "Wix Payment ID", the unique identifier of this order in Wix, corresponding to the "Merchant reference (Optional)" in the Merchant Portal.
4. For a detailed overview, click on the small item next to the "Wix Payment ID". In a new window, you will find the "Worldline payment ID", corresponding to the payment.id on the Worldline platform. Refer to this identifier when contacting our support for helping you troubleshoot a transaction.  
5. Access the "Order activity" log to look up the transaction's history, including the order's status and refunds performed via Wix. 

To get an overview of all processed orders, go to Sales > All payments in the dashboard. Look up individual orders as described above. 

To look up the order in the Merchant Portal, use the "Wix Payment ID"/"Merchant reference (Optional)" as described in our dedicated guide. 

Perform refunds

Refunds are standard processes (also known as maintenance operations) in your everyday business logic. Learn here how to perform these operations in Wix.

1. Log in to your Wix account. In the dashboard, go to Sales > Orders. Click on the order you want to refund.
2. To perform the actual refund, you have two options: 
   a) In the "Payment info" section, click on "Actions" and select "Refund" from the dropdown menu. In the subsequent screen, specify the amount to refund. If needed, you can issue multiple partial refunds per order. 
   
   b) In the "More Actions", you can either choose "Refund" to perform a (partial) refund without impacting the order's status otherwise or choose "Cancel & Refund" to cancel the order and perform a full refund. 
3. Upon successfully refunding an order, Wix will automatically update the order's status to "Refunded" or "Partially Refunded" accordingly. 

Mind that some payment methods might have limitations on allowing multiple partial refunds or partial refunds in general.