Menu

Please select your page

Plugin

WooCommerce payment plugin for AfterPay and Buy Now Pay Later

WooCommerce is a popular extension for the WordPress online publishing platform, which turns a WordPress instance into a fully functional webshop. AfterPay has developed a plugin that easily integrates with a WooCommerce webshop. It is a simple way to let your customers start using AfterPay at checkout. You don't need advanced technical skills to add AfterPay to your webshop!

Website:
https://woocommerce.com/

Type:
Plugin


Introduction

This guide describes the steps to quickly install, configure, test and activate the AfterPay payment methods in your WooCommerce store.

We offer 5 different payment options:

The payment methods that are available via this plugin can be found in this table:

Setup

This document assumes you already have a working, configured WordPress site, with the WooCommerce extension installed. If you don't, you can download the software and learn how to use it here.

Many web hosting services have a backend tool that lets you install popular software packages with just a few clicks, and WordPress is often included in those.

In this chapter we will explain how you can install and configure AfterPay for your webshop.

Installation

You can install the AfterPay plugin via the WordPress Marketplace, by searching from your Plugins tab in the WordPress Admin, or here.
After installing the plugin, make sure to activate it.

Upgrade the plugin

If you have installed the plugin via the WordPress Marketplace, it should update automatically.

Basic settings

Each combination of a country (Netherlands, Germany, Sweden, etc.) and AfterPay payment method (14-Day Invoice, Direct Debit, Part Payment) is a separate payment method under the Payments settings. In some countries, there are also separate B2B payment methods for business-to-business (as opposed to business-to-consumer) sales - this accounts for different tax handling, etc.

You can have more than one payment method enabled in each country.

To configure your payment methods:

1) Open the WordPress Admin Panel.
2) In the left-hand menu, go to WooCommerce > Settings, then select the Payments tab.
3) Flip the Enabled switch for a payment method to enable that combination. (Country and AfterPay payment method)
4) Click Manage/Set up next to a payment method to open its configuration screen.

MicrosoftTeams-image (51).png

Tax settings

AfterPay assumes that your WooCommerce webshop already has the correct tax classes - the VAT categories and tax rates for your products. In some countries, certain items such as books, food, event tickets, etc. may have VAT rates that are smaller than usual, or even zero. These rules must be configured to ensure that AfterPay handles tax, invoicing and settlement correctly.
See WooCommerce's own documentation for help.

Testing

After completing the setup of the module the next step is to test the connection.

Standard test scenarios

Please submit the following test scenarios. To check your own test transactions proceed to paragraph check test order. Complete the table with your order numbers and send it to your AfterPay Implementation Manager. You can put multiple test cases in one order but please refer to the right order number after each testcase.

# Test case Order number
1. Test an order with multiple products
2. Test an order with a fixed discount
3. Test an order with a percentual discount
4. Test an order with a shipping fee
5. Test an order with an alternate delivery address
6. Test an order with pick-up points (if applicable)
7. Test an order with store pick-up (if applicable)
8. Test an order with a house number addition
9. Test and make sure the VAT is correcly received by AfterPay
10. Test an order with a payment fee if applicable (not recommended to be used)

Payment method scenarios

After you tested all standard scenarios for the 14 day invoice you should start testing the other payment methods you activated. Please complete the tables with your order numbers and send it to your AfterPay Implementation Manager.



If you want to integrate invoice for Business to Business please proceed with this test order:

# Test case Order number
B-1. Test an order with the Business to Business payment method



If you want to integrate Direct Debit please proceed with this test order:

# Test case Order number
D-1. Test an order with the Direct Debit payment method



If you want to integrate Instalments please proceed with these test orders:

# Test case Order number
I-1. Test an order with 3 month instalments
I-2. Test an order with 6 month instalments (if applicable)
I-3. Test an order with 12 month instalments (if applicable)



If you want to integrate a Campaign invoice please proceed with this test order:

# Test case Order number
C-1. Test an order with the Campaign invoice payment method

Customer facing messages

It is also necessary to check if the error messages are correctly shown to the customer.

Check test order

You are able to verify the transactions on the AfterPay side by yourself. You can do this with the "GET ORDER" call. You can send these calls for example with Postman. The response will show you how the transactions a registered on the AfterPay side. Documentation for the "GET ORDER" call can be found below.

GET /api/v3/orders/{orderNumber}

Returns the contents of the specified order

Visual guidelines

In this chapter we will explain the AfterPay visual guidelines you need to apply to your webshop.

Logos and banners

For convenience and a familiar customer experience, please integrate/enclose the AfterPay logo in your Checkout next to the payment method. Please refer to our Merchant Playbook for full details on how to make the customer experience smooth and frictionless.

When Implementing the AfterPay logo throughout the shopping experience please ensure you are using our URL, not by downloading the image. The AfterPay logos are hosted on a Content Delivery Network (CDN) to ensure the best performance and availability for your website. Furthermore, you do not have to care about changes, which are all done by AfterPay.

We provide two types of logos through our CDN - .svg and .png. We recommend using the AfterPay logo as a .svg file with regard to the quality and size of the file. If you prefer .png just change the end of the URL to .png. We also offer the AfterPay logo in different color schemes. Depending on your individual website background, choose the AfterPay logo that fits best.

Description Copy URL Logo
AfterPay Checkout Logo in SVG, 4.3Kb https://cdn.myafterpay.com/logo/AfterPay_logo_checkout.svg AfterPay Checkout Logo in SVG, 4.3Kb
AfterPay Black Logo in SVG, 5.44Kb https://cdn.myafterpay.com/logo/AfterPay_logo_black.svg AfterPay Black Logo in SVG, 5.44Kb
AfterPay White Logo in SVG, 5.61Kb https://cdn.myafterpay.com/logo/AfterPay_logo_white.svg AfterPay White Logo in SVG, 5.61Kb

Terms and conditions

AfterPay mandates that it is mandatory for a consumer to be presented with AfterPay's terms and conditions and Privacy Policy upon checkout. Thus the option to display the T&C should be always enabled in the plugin configuration. In certain cases where you would like to incorporate the AfterPay T&C and Privacy Policy within your own Terms and Conditions, this must be done only with approval from AfterPay's legal counsel. After approval include the country specific T&C and Privacy Policy resources.




Go-live

In this chapter we will explain which steps you need to take to enable the payment method on production.

Configure live mode

Done

Congratulations! You just went live with your AfterPay connection. Please notify your AfterPay Implementation Manager that you went live. If you encounter any issues in the upcoming week you can contact your AfterPay Implementation Manager. After that period you can contact our local Merchant Desk for help.

Introduction to the AfterPay Merchant Portal

You can go to the Merchant Portal here. Once logged in, you will also see an in-depth guide on how to best use it.

In the merchant portal you can:





Support

Payment method settings

This sections describes the full list of payment methods setting available in the AfterPay plugin.
Please note not every setting is available in every payment method.

Field Description
Enable/Disable Check the box to make this AfterPay payment method available to your webshop's customers in this country.
Title Enter the name of the payment method, as it will appear to the customer on the checkout page.
Extra information Enter the extended information shown to the customer at checkout. This can be a detailed description, information about current campaigns, etc.

Merchant ID, Portfolio Number, Portfolio Password are only applicable for The Netherlands and Belgium

Field Description
Portfolio Number Enter the Portfolio Number you got from your Key Account Manager.
Portfolio Password Enter the Portfolio Password you got from your Key Account Manager.
API Key The Auth key for transactions. You can get a test Auth key from your Key Account Manager. You must use a separate Auth key for each country, but you can use the same Auth key for each payment method in the same country.
Lower threshold The minimum shopping cart value for which AfterPay will be available as a payment method. Value is in the country's local currency.
Upper threshold The maximum shopping cart value for which AfterPay will be available as a payment method. Value is in the country's local currency.
Test Mode Check this box to tell AfterPay that you are making test transactions. In Test Mode, customer verification/risk checks always return positive, transactions won't be rejected because the address is wrong, and the money will not be added to the merchant's settlement account. There will be no emails sent to the customer, and no Customer Portal where they can pay the invoice.
Debug mail If you enter an email address here, the complete technical details of each AfterPay transaction in your webshop will be sent to that address.
Show phone number Check the box to ask the customer for their phone number in the AfterPay section of the checkout page. If your WooCommerce checkout page is already configured to collect the customer's phone number, you can leave this unchecked.
Show date of birth This setting should be enabled by default.
Show gender Check the box to ask for the customer's title (Mr/Mrs, etc.) in the AfterPay section of the checkout page.
Show terms and conditions Check the box to display AfterPay's Terms & Conditions text and checkbox in the AfterPay section of the checkout page. The content is provided automatically by the AfterPay plugin. The text will be in the country's local language, and specific to that country's legal requirements.
Exclude shipping methods Do not show AfterPay if selected shipping methods are used.
Use custom housenumber field Enter a custom label for the "House Number" field in checkout. Leave empty to use the default label.
Use custom housenumber addition field Enter a custom label for the "Apartment Number" field in checkout. Leave empty to use the default label.
IP restriction If you enter an IP address, this payment method will only be displayed to customers coming from that public IP address.This is useful in testing mode - you can show the payment method only to your own computer or office network until you are ready to go live. To find your current public IP, go to Google.com and type in "what is my ip".
Enable captures If you check this box, the plugin will attempt to Capture the orders automatically. Do not check this box if you have a warehouse/stock management system that is separately integrated with AfterPay (using the same Auth key), and it sends the Capture call when an item is shipped, independently of the WooCommerce webshop.
Way of captures Automatically after authorization - the plugin will make a Capture as part of the checkout process. Based on Woocommerce Status - the plugin will make a Capture when the order is set to a particular status in the webshop. (See below)
Status to capture based on If Way of captures is set to Based on Woocommerce status, the plugin will capture the invoice amount as soon as the order is set to this status.
Enable refunds Check this box to allow refunds from the webshop's backend interface. They will be processed by AfterPay. Otherwise, any refund to the customer will have to be handled entirely outside AfterPay. To refund an order via AfterPay, open your Wordpress Admin Panel and go to WooCommerce > Orders > click on an order > Refund. You will have two options: Refund manually (outside of AfterPay) and Refund via AfterPay.
Refund tax percentage The VAT rate used when you make a refund via AfterPay. Because the AfterPay module can refund a given amount (but not individual invoice items), the VAT share of the original invoice amount needs to be handled correctly. If you have items that were charged at a non-standard VAT rate, use Refund manually.
Compatibility with Germanized Check this box to use a Title (Mr/Mrs/etc.) field that's customized for German-speaking countries, instead of WooCommerce's generic Title field.
Enable profile tracking Check this box to enable the Profile Tracking fraud-detection mechanism. Contact your Account Manager for more info about setting this up.
Client ID for profile tracking Your unique ID for the Profile Tracking mechanism. This can be provided by your Account Manager.

Compatibility

The plugin has recently been checked for compatibility with the following Woocommerce versions and external plugins. The compatibility of external plugins is not part of the default test cases for release.

Woocommerce 5.1.0
Wordpress 5.7.0
Germanized 1.9.6
Payment Gateway Based Fees and Discounts for WooCommerce 2.3.1

Release notes

Version 5.7.0 - Released: 04.11.2021

Fixed:

  • Fixed issue with conflicting GuzzleHttp libraries.
  • Fixed issue with image urls using variables, which are not allowed by the AfterPay API.
  • Fixed issue with frontend validation on birthdate, when nothing entered.
  • Fixed issue with too much decimals in vatAmount.

Version 5.6.0 - Released: 01.11.2021

Fixed:

  • Fixed issue with too much decimals in vatAmount.

Version 5.5.0 - Released: 30.09.2021

Added:

  • Added plugin data fields in the 'authorize' and 'available payment methods' calls.
  • Added Date of Birth to all payment methods for DE, AT, CH, DK, NL and BE.

Changed:

  • Updated PHP Library to version 3.4.0.
  • Update styling to new logo.
  • Removed BIC from bank account validation, direct debit and installments.

Fixed:

  • Fixed issue with overwriting settings.