WooCommerce

Get started

Acquired.com's WooCommerce plugin is designed for everyone, emphasising accessibility, performance, security, and ease of use.

Click here to get started with your WooCommerce integration.

---

Set up WooCommerce

Thank you for downloading the Acquired.com for WooCommerce extension. To get started you will first need access to our test environment so you can complete the required configuration steps to start accepting payments. If you don’t already have one, click here.

Once the test account has been created, you will receive an email containing the required information to configure the extension as well as how to access our back office Hub where you can view transactions, customise the payment form and set up different payment methods.

If at any point you need help with the extension, please contact [email protected] or call us on +44 (0) 203 982 5680.

---

System requirements

Your store must be running on Wordpress 5.7.2 & PHP 7.4 or higher.

---

Installation

We recommend that you install the extension from the Wordpress marketplace by following these steps:

1. Login to the Wordpress admin panel: https://yourdomain.com/wp-admin
2. From the sidebar, navigate to Plugins > Add New.
3. In the search bar, top right corner, enter Acquired.com.
4. Click on Install Now.
5. Once the installation process is completed, click Activate.
   

---

Configuration

Once the installation process is complete, from the Wordpress sidebar:

1. Navigate to WooCommerce > Settings.
2. Select Payments.
3. Select Acquired.com for WooCommerce.
4. There will be 4 tabs to navigate through and configure:

• General
• Card payments
• Apple Pay
• Google Pay

---

General: configuration

---

Card payments: configuration

Display Payment Form methods:

• i-Frame Redirect: after selecting Pay by Card and hitting the Place Order button the cardholder will be redirected to a page added by the plugin titled “Acquired Payment”. The page will inherit elements of your selected theme. Navigate to Pages on the Wordpress sidebar and select Acquired Payments - where you position the [acquired_iframe] element will determine where the payment form is displayed.
• i-Frame Popup: after selecting Pay by Card and hitting the Place Order button, a modal containing the payment page will be displayed to the user to complete the payment.
• Redirect: after selecting Pay by Card and hitting the Place Order button the cardholder will be fully redirected to our environment to enter their card details.

📘

Note

You have complete control over the styling of the payment form - see styling the payment form and selecting the payment form.

---

EMV 3-D Secure: configuration

---

Saved cards: configuration

These settings need to be configured if you choose to allow customers to use previously used cards.

---

Apple Pay: configuration

Alongside the configuration below, you will need to login to the Acquired.com Hub in order to complete the Apple Pay setup. (See our Apple Pay guide here).

Depending on how you have built your checkout flow within WooCommerce there are 3 places you can display the Apple Pay button:

• Product: will be displayed below the Add to Cart button.
• Cart: will be displayed below the the Proceed to Checkout button.
• Checkout: will be displayed as a payment option along with Pay by Card.

📘

Note

You can choose to support all or just some of the above options depending on your preference.

---

Google Pay: configuration

Depending on how you have built your checkout flow within WooCommerce there are 3 places you can display the Google Pay button:

• Product: will be displayed below the Add to Cart button.
• Cart: will be displayed below the the Proceed to Checkout button.
• Checkout: will be displayed as a payment option along with Pay by Card.

📘

Note

You can choose to support all or just some of the above options depending on your preference.

---

Order status: configuration

View the WooCommerce managing orders documentation here.

---

Card payments

The Acquired.com for WooCommerce extension uses our Hosted Payment Page (HPP) solution in order to process payments securely.

Card details are entered directly into our environment so you comply with PCI DSS SAQ-A, while allowing you to fully customise the payment form.

When your account is first created we will load our default HPP template. We encourage you to update the form to meet your requirements and brand by changing the HTML & CSS.

---

Finding your MID

As part of the configuration process for Card Payments you will need to locate the 4 digit MID value which is located in the Hub.

Please follow these steps:

1. From the sidebar, navigate to Settings > MIDs.

2. Here you will see all available MIDs which can be used on your account. For card payments the bank name will be set to "Test Bank".

3. Copy the 4 digit MID value in the Acquired Company MID ID field of the currency you want process and populate that value in your Acquired.com WooCommerce plugin MID field.
   

---

Styling the payment form

Once you have found your MID, you can update the styling of the Payment Form to match the branding of your website.

How you style it may depend on how you choose to Display the Payment Form, so please have a look at the available options before getting started. A default Hosted Payment Page (Form) will be automatically added to your account.

1. Click on the 3 dots in the Action column of the MID and select Edit Service.

2. Click on the Download button to get a copy of the default template.

3. Open the index.html file in your favourite text editor and make any changes you’d like to styling, error messaging or field descriptions.
4. When you are done editing, save the files, add any required images or font files to the folder and compress it into .zip format.
5. Return to the Hub, click on the 3 dots in the Action column of the template table and select File to overwrite the default (or create a new one by selecting New Template).
6. Click the Choose File button and locate the .zip folder on your machine to upload it.
7. When the file name is displayed on the button, hit Submit to upload it to our system.

• In the test environment, the template will automatically be approved.
• In the live environment, the template will need to be reviewed by our team before being made available for use.

📘

Good to know

In index.html replace the {{cdn_url}} tag with https://qahpp.acquired.com/cdn to see how the payment page will display locally - just ensure you change it back before uploading it.

---

Selecting the payment form

To provide you with some flexibility on how your styled payment form is displayed to the user, we’ve added 3 options to choose from.

i-Frame redirect

When the extension is installed and activated on your Wordpress site a new page will be added called “Acquired Payments” - navigate to and edit this page.

Wherever you position the [acquired_iframe] tag within this page is where the form will load.

i-Frame popup

After clicking Place Order, a modal will be displayed overlaying the Checkout page for the user to enter their card details and complete their purchase.

Redirect

After clicking Place Order, the user will be redirected to our environment to enter their card details and complete their purchase. Once complete, they will be redirected back to your website and displayed with an order confirmation page.

---

Saved cards

Acquired.com are a fully compliant PCI DSS v3.2 service provider. We can securely store your sensitive cardholder data using our tokenisation solution.

We ensure this by giving your customer the option to store their card on the checkout by clicking Remember Card, allowing them to reuse this card upon their next payment.

The tokenised (stored) card can then be used to process what we call “One Click Checkout”, where your customer will only be asked for their card cvv.

At the checkout, your customer will have the choice of paying with a previously stored card or use a new card.

If you decide to use this feature, you will need to upload a second HPP template in the Acquired.com dashboard and follow the same steps as above in the styling the payment form section.

Set up saved cards

1. Download the default template.
2. Scroll down in the index.html file until you find the following line of code and remove it:
   <input type="hidden" name="is_remember" id="is_remember" value="1">
3. When you are done editing, save the files and compress it into .zip format.
4. Return to the Hub, click on the 3 dots in the Action column of the template table and click New Template. (Ideally name this new template, "Saved Cards Template", to distinguish which one it is.)

5. Click the Choose File button and locate the .zip folder on your machine to upload it.
6. When the file name is displayed on the button, hit Submit to upload it to our system.
7. After you submit the file, click on the Back To List button so you will be taken back to the list of HPP templates you have stored against your Acquired.com merchant account.

8. Make note of the Template ID displayed next to your Saved Cards Template, you will need it in the next steps.

9. In your WooCommerce Admin Panel, navigate to Settings > Card Payments.
10. Scroll down to the Saved Cards section and enable this feature by clicking on Save Cards.
11. In the Save Cards Template ID field add the 4 digit Template ID you previously made note of and save the settings.

---

Apple Pay

The Acquired.com for WooCommerce extension makes use of the Apple Pay Web Registration API.

This means that you do not need to have an Apple Developer account or to manage your own certificates. To use Apple Pay, please make sure that both in the Sandbox and Live environments, all web pages hosting an Apple Pay button are HTTPS and your web server supports TLS 1.2.

The Apple Pay button will only display when using a supported version of Safari and the device has at least 1 acceptable payment method setup.

---

Registering your domain

Test

1. Log into the Hub.
2. From the sidebar, navigate to Settings > Payment Methods > Apple Pay.
3. In Web Domains click + Add Domain.
4. Enter the domain (yourdomain.com) or subdomain (shop.subdomain.com) of your WooCommerce site where the Apple Pay button will be displayed.
5. For test environments, you do not need to download or host the verification file.
6. Click on Register Domain.

📘

Good to know:

There are special requirements in order to test Apple Pay in the test environment - see Testing Apple Pay for more information

Live

1. Log into the Hub.
2. From the sidebar, navigate to Settings > Payment Methods > Apple Pay.
3. In Web Domains click + Add Domain.
4. Enter the domain (yourdomain.com) or subdomain (shop.subdomain.com) of your WooCommerce site where the Apple Pay button will be displayed.
5. Download the verification file (apple-developer-merchantid-domain-association). The file name must not be changed or the registration will fail.
6. If you have SFTP access to your site Create a new folder at root level name .well-known. Upload the verification file into the folder.
7. If you do not have SFTP access, from the Wordpress sidebar, navigate to Plugins > Add New. In the search bar, in the top right corner, enter File Manager. Click on Install Now.

8. Once the installation process is completed, click Activate.
9. Once activated, click on WP File Manager.
10. You will be presented with the folder structure of your Wordpress website.
11. On the left hand side, right click on the top folder displayed. (In the screenshot it is called Wordpress, but may be named differently on your site.)

12. Select New folder and name it .well-known.
13. Double click on the .well-known folder and drop the verification file onto the screen from your computer.
14. At this point, if you have been logged out of the Hub don’t worry you do not need to start the process again - just complete Steps 1-4 again.
15. Click on Register Domain.

---

Testing Apple Pay

The process for testing Apple Pay in the test environment requires a number of steps. If you are not already familiar with it please read the Apple Developer documentation.

📘

Note

In order to complete testing we recommend that you have a separate Apple device to your main device and to create a new Apple ID.

---

Google Pay

The Acquired.com for WooCommerce extension enables you to process Google Pay transactions. However, before going live, you will be required to register with Google via the Business Console so that they can approve your site for production use.

Please make sure that both in the test and live environments, all web pages hosting a Google Pay button are HTTPS and your web server supports TLS 1.2.

The Google Pay button will only display when using a supported version of Chrome and the device has at least 1 acceptable payment method setup.

---

Register with Google

Please follow the instructions on the Google Business Console to register your business for processing Google Pay transactions.

---

Testing Google Pay

Testing Google Pay requires a number of steps. If you are not already familiar with it, please read the Google Developer documentation.