WooCommerce (3rd Party)
Introduction
Our WooCommerce (3rd Party) plug-in comes with regular updates and full integration support, offering a versatile out-of-the-box solution to accept online payments easily:
- Ideal solution for businesses of any size using WordPress.
- Supports Hosted Checkout Page integration method.
- Offers all available payment methods on our platform.
Keep an eye on our Release Notes to stay informed about updates and new features (i.e. payment methods, features, integration methods) we have added to this plugin!
Check out our documentation to learn how to link your store with our platform to profit from all these features!
Account Creation
To process transactions with this plugin, you need an account on our platform.
This plugin works with both our test and live environments. A test account is a great way to get familiar with both the plugin and our platform. Once you want to go live, contact us!
Installation
Installation
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 | |
| ANZ Worldline Payment Solutions credentials |
|
| PCI compliancy |
SAQ A |
Once you have purchased the plugin, you will find a detailed installation wizard inside the package, guiding you through the installation process.
Configuration
After the installation, you need to configure the plugin to link your store to our platform.
- Login to the WooCommerce (3rd Party) Back Office. Go to WooCommerce (3rd Party) > Payments. Select "AG Worldline Hosted Checkout for WooCommerce (3rd Party)" by clicking on the "Manage" button
- Configure the following settings:
Property Description/Actions Enable/Disable
AG Worldline Hosted Checkout for WooCommerceEnable/Disable the plugin
Set the flag to link your shop to our platform for test/live transaction processing.
Title Select a title to appear on the shop's checkout page. Description Select a description to appear on the shop's checkout page. Merchant ID Enter the PSPID on our platform you want to use for transaction processing. API Key Enter the API key of your test or live PSPID. Read our dedicated guide to learn how to generate one. API Secret Enter the API secret of your test or live PSPID. Read our dedicated guide to learn how to generate one. Test mode (Un)Flag "Enable Test Mode" to link your shop to the respective environment. Depending on your selection, the shop module will send the transaction requests to the test or production environment. Operation Define whether to process the transactions as authorisation mode or as direct sale. Select one of the following options:
- "Authorize": The amount is only blocked on your customer's card. Successful transactions will have statusCode=5/status="PENDING_CAPTURE" /
statusOutput.statusCategory="PENDING_MERCHANT"
Use this mode when you wish to capture a transaction only after shipping the order). In the WooCommerece Back Office, the status will be "Completed". - Sale: The amount has been ordered to be paid out in one go. Successful transactions will have status="CAPTURED" /
statusOutput.statusCategory="COMPLETED" /
statusOutput.statusCode=9
In the WooCommerece Back Office, the status will be "Processing".
If "Operation" is set to "Authorization", make sure you capture authorised transaction later. Only then will the transaction reach statusCode=9, for which you receive the actual payment for the transaction.
Accepted Cards Select the credit card payment methods available to your customers on our secure payment page. If left empty, all active payment methods in your PSPID are selectable. - "Authorize": The amount is only blocked on your customer's card. Successful transactions will have statusCode=5/status="PENDING_CAPTURE" /
Make sure to:
- Not to mix up credential from test with live (property "Test mode") and vice versa when configuring fields “Merchant ID”/”API Key”/”API secret.
- To unflag “Enable Test Mode” in property "Test mode" as soon as you have finished your tests.
- Click on "Save" to confirm your settings.
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, refunds and cancellations of authorisations are standard processes (maintenance operations) in your everyday business logic. Learn here how to perform these operations directly in the WooCommerce Back Office:
- Login to the WooCommerce (3rd Party). Go to WooCommerece (3rd Party) > Orders. Click on the order in the table.
- In the order overview, click on one of the available buttons to cancel/capture/refund the order. Depending on the order’s status, the following buttons are available.
Order status Available buttons statusOutput.statusCode=5 /
Completed- "Worldline Capture Payment": Capture the authorised amount to receive the funds for the order.
- "Refund": Cancel the authorised amount.
statusOutput.statusCode=9 /
Processing- "Refund": Reimburse the funds for the order.
- This plugin will only process authorised transactions: The amount is only blocked on your customer's card. Successful transactions will have statusOutput.statusCode=5.
- Therefore, make sure that you capture them later. Only then will the transaction reach statusOutput.statusCode=9, for which you receive funds.
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.
Make sure to switch to the LIVE environment as soon as you have finalised your tests.