BigCommerce

Introduction

Our BigCommerce plug-in comes with regular updates and full integration support, offering a versatile out-of-the-box solution to accept online payments easily:

• Supports both Hosted Checkout Page and Hosted Tokenization Page integration modes

• Offers the following payment methods on our platform:
  Alipay+
  American Express
  Diners Club
  Google Pay
  MasterCard
  PayPal
  Visa
  WeChat Pay

• Accepts payment operations (Refunds, authorizations, captures etc.) directly from your PAYONE E-Payment account.

Keep an eye on our Release Notes to stay informed about updates and new features (i.e. payment methods, features, integration modes) we have added to this plugin!

Download plugin

To process transactions with this plugin, you need an account on our platform.

This plugin works with both our test and live environment. A test account is a great way to get familiar with both the plugin and our platform. Once you want to go live, create a production account or contact us!

Install plugin

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

Item	Description
Plugin package	Download the plugin
PAYONE E-Payment credentials	Active test/live account on our platform API key/secret Webhooks
BigCommerce	No specific requirements, compatible with every store
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.

Once done, follow these steps:

1. Go to Apps > Marketplace. Click on the “BIGCOMMERCE.COM/APPS” button to access our app store. Search for "Worldline Online Payments Connector" and click on the "GET THIS APP" button.
2. Login to the BigCommerce Back Office. Go to Apps > Marketplace. Click on the “Install” button and follow the installation instructions.

Configure Plugin

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

Configure Basic settings

1. Login to the BigCommerce Back Office. Go to Apps > My apps > Worldline > My Account to configure the following settings:
   

   Property	Description/Actions
   Modes	Select between "Sandbox Mode” or "Live Mode” to link your shop to the respective environment and to configure the respective test/live credentials. Depending on your selection, the shop module will send the transaction requests to the test or production environment. Make sure to: Not to mix up credential from test with live and vice versa when configuring fields PSPID/API and webhooks credentials. To switch to "Live Mode" as soon as you have finalised your tests.
   Test/Live PSPID	Enter your test/live PSPID from our platform that you want to use for transaction processing.
   Test/Live API Key	Enter the API Key of your test or live PSPID. Read our dedicated guide to learn how to generate one.
   Test/Live API Secret	Enter the API Secret of your test or live PSPID. Read our dedicated guide to learn how to generate one.
   Test/Live Webhooks Key	Enter the Webhooks Key of your test/live PSPID from the Merchant Portal as described in our dedicated guide.
   Test/Live Webhooks Secret	Enter the Webhooks Secret of your test/live PSPID from the Merchant Portal as described in our dedicated guide.
   Webhooks URL	Copy this URL into the Endpoint URLs fields in the Merchant Portal as described in our dedicated guide.
   Redirection Payment Page URL - Test/Live	The URL we redirect your customers to after the test/live payment has been finalized. Applies only to Redirect Mode A / B

2. Click on "Connect” to confirm and validate your settings by establishing a test connection between the plugin and our platform. Check that the screen displays “Welcome! Enable your Complete Checkout Solution here!”. If the text does not appear, contact your system administrator for troubleshooting to check:
   a. You are using the correct credentials
   b. Whether your PSPID is active
   c. You send the request to the correct PSPID/environment (Test vs Production)

Configure payment methods

1. Login to the BigCommerce Back Office. Go to Apps > My apps > Worldline > Payment Methods to configure the following settings:
   

   Property	Description/Actions
   On Site Mode: Card Payments Only	Configure/Enable/Disable card payments via Hosted Tokenization Page integration mode Your customers stay in your webshop checkout page while entering their card details in an iframe hosted on our server. The iframe presents a single payment method as defined in property "Pay Button Title". It autodetects the card brand based on card number input. If you disable this feature, make sure enable in the "Redirect Mode A" or "Redirect Mode B" to ensure card payments are possible.
   Redirect Mode A: Payment Method selection before redirection	Configure/Enable/Disable both card and non-card payment methods via Hosted Checkout Page integration mode. Your customers select a payment method and confirm the order in your webshop checkout page by clicking on the "Custom Payment” button. The plugin then redirects your customers either: > To a version of our Hosted Checkout Page that is branded according to the selected payment method. > The third party provider offering the selected payment method.
   Redirect Mode B: Payment Method selection after redirection	Configure/Enable/Disable both card and non-card payment methods via Hosted Checkout Page mode: Your customers confirm the order in your webshop checkout page by clicking on the "Custom Payment" button. The plugin then redirects your customers to our Hosted Checkout Page to allow them selecting their preferred payment method.
   Custom Payment Button	Customise the payment button text/color on your webshop checkout page.

2. Configure the following properties in "On Site Mode: Card Payments Only":
   a. Pay Button Title: Customise the heading of the iframe.
   b. Payment Option: Define whether to process the transactions as authorisation mode ("Capture on Shipment") or as direct sale ("Capture on order placed").
   If you select "Capture on Shipment", beware of the following: Make sure that you capture authorised transaction later. Only then will the transaction have status "9 - Captured".
   c. Template File Name: Enter the file name of your template to adapt the iframe to the look and feel of your shop. To learn how to create templates, see our dedicated chapter in the  Hosted Tokenization Page guide.
   d. Display Logo for Accepted Card Brands: Add logos for available card payment methods to the iframe. Make sure to check add only logos for payment methods active in your account.
   
   
3. Configure the following properties in "Redirect Mode A: Payment Method selection after redirection":
   a. Send Order Data: Send order line items details in your transaction request.
   b. Payment Option: Define whether to process the transactions in authorisation mode ("Capture on Shipment") or in direct sale mode ("Capture on order placed").
   If you select "Capture on Shipment", beware of the following: Make sure that you capture authorised transaction later. Only then will the transaction have status "9 - Captured".
   c. Template File Name: Enter the file name of your template to adapt the Hosted Checkout Page to the look and feel of your shop. To learn how to create templates, see our dedicated chapter in the Hosted Checkout Page guide.
   
   
4. Configure the following properties in "Redirect Mode B: Payment Method selection after redirection":
   a. Send Order Data: Send order line items details in your transaction request.
   b. Generic Logo Displayed on Your Payment Page: Add a logo to the Hosted Checkout Page that matches the the look and feel of your shop.
   c. Pay Button Title: Customise the radio button text in your webshop checkout page for the payment methods processed via the Hosted Checkout Page.
   d. Template File Name: Enter the file name of your template to adapt the Hosted Checkout Page to the look and feel of your shop. To learn how to create templates, see our dedicated chapter in the Hosted Checkout Page guide.
   e. Group Cards: Group all cards payment methods under one single button on the Hosted Checkout Page.
   f. Payment Option: Define whether to process the transactions in authorisation mode ("Capture on Shipment") or in direct sale mode ("Capture on order placed").
   If you select "Capture on Shipment", beware of the following: Make sure that you capture authorised transaction later. Only then will the transaction have status "9 - Captured"
   
   
5. Configure the following properties in "Custom Payment Button":
   a. Place Order: Customise the button text of order confirmation button in your webshop checkout page.
   b. Background/Text/Outline: Customise the coloring of order confirmation button in your webshop checkout page.
   
   
6. Click on "Save Changes" to confirm your settings.
7. Click on "Enable Worldline Checkout" to enable the plugin.

Manage payments

We have designed the plugin to follow-up on your orders automatically and autonomously, freeing you from the administration involved. Learn here how to use our plugin effectively which could help your business to thrive!

Perform Maintenance Operations

Captures and refunds of authorisations are standard processes (maintenance operations) in your everyday business logic. Learn here how to perform these operations directly in the BigCommerce Back Office:

1. Login to the BigCommerce Back Office. Go to Apps > My apps > Worldline > Order Details.
2. In the order overview, depending on "Worldline Payment Response", the following buttons are available in the "Actions":
   9 – Captured: Reimburse the funds for the order via the "Refund" button. You can adapt the amount in the subsequent screen for a partial refund
   Mind that our plugin allows only one refund operation for every transaction
   5 - Pending_capture: Capture the authorised amount to receive the funds for the order via the "Capture"

Perform test transactions

Use our platform's test environment to make sure your plugin works as intended. We offer test data sets on our dedicated Test cases page. Target our test environment as described in the "Configure Plugin" section.