> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.afterpay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.afterpay.com/_mcp/server.

# Afterpay Gateway Configuration

## Install Afterpay APP

Completing the below steps will enable Afterpay as a Payment Method and display the Afterpay assets on the product pages.

1. Login to your eCommerce Store

![lightspeed-1.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/5715699a33e990d955c980a4d3ddb16ea5bd530cffc5e12aea86864e7ed3ae1a/afterpay-online-dev-docs-1/assets/images/lightspeed-1-2.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=91272180e43c2b7a417a291e320c500408924136d1589f19a921fb05d824099a&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

2. Navigate to \_Apps \_

![Lightspeed-2.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/3dc77657ccbf6d700873b3d54bca3f744dd523687405a7b43433d5dd95338c29/afterpay-online-dev-docs-1/assets/images/Lightspeed-2.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=042a63cd39454c40c8c0206b5f143d094d680e04a6f7edf32da360ab53fb3af9&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

3. Enter 'Afterpay' in the search field at the top right

![Lightspeed-3.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/3bf812e927d1c1e5fe84c719080f513f9611cb522f29f07b5d3684a2cb41f1e4/afterpay-online-dev-docs-1/assets/images/Lightspeed-3.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=90c76b6384223c0c916f0b8b5c34be852996821da5191841929a7fe011b15822&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

4. Click Install

5. You will be asked to ‘Install Afterpay Payment Integration’

   * Enter your Website Username/ Password

   * Click ‘Next’

![Lightspeed-4.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/e7379305321c6eca8f8736a0f07d27ff69656bc658e24025fb95fbc517e0e857/afterpay-online-dev-docs-1/assets/images/Lightspeed-4.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=ebd3c1783248df250e14db3727c2b8d1865b8ff6332b4a5da78ee85234a2fce5&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

6. Notification of Plugin required access appears:
   * Review access requirements
   * Click ‘Grant Access’

![Lightspeed-5.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/5a6931e43526f2a050d7c5bbead845dda1fc39d14a13535b31f102ade5eb845c/afterpay-online-dev-docs-1/assets/images/Lightspeed-5.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=e53d8cbd3870d799bb01bfaabb67738da50d430cf4fb99c7b7d6fa4548ac0a6d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

7. Login or Create a New AdVision Lightspeed eComm App account (if you don’t have one).

   * Click ‘Login’ or ‘Register now’

![Lightspeed-6.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/eceb96b9e27549cb1d9687716f1577052b1f002738d69d2ea2dda9036c40011f/afterpay-online-dev-docs-1/assets/images/Lightspeed-6.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=70730ef24314595abdab6cac313983e23456bac895476c169f900b2648909d1b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

8. You will be redirected to the Afterpay Payment Gateway settings page.

   * If not, Navigate to *Apps > Purchased Apps > Afterpay Payment*

## App Configuration

If you're not already on the configuration panel, to get to your Afterpay APP configuration panel.

1. Login to your eCommerce Store.

2. Navigate to  *Apps > Purchased Apps > Afterpay Payment*.

3. Click on Afterpay Payment Integration.

4. Click go to APP at the top right.

Next, follow the steps below to complete your configuration.

1. Enable the "Active" Checkbox ( to the right of the first APP option )

2. Scroll down and use the Afterpay Setup Values and Page Values to configure your APP.

## Afterpay Setup Values

| Option                           | Value                                                                                           |
| -------------------------------- | ----------------------------------------------------------------------------------------------- |
| Display                          | Afterpay - Pay by Installments                                                                  |
| Icon                             | Afterpay                                                                                        |
| Endpoint                         | AU                                                                                              |
| Mode                             | Live                                                                                            |
| Merchant ID                      | Enter the Merchant ID provided by Afterpay into this field.                                     |
| Secret Key                       | Enter the Secret Key provided by Afterpay into this field.                                      |
| Currency Code                    | AUD                                                                                             |
| Auto Generate Order              | Tick Enabled                                                                                    |
| Show Instructions to Customer    | Leave Blank                                                                                     |
| Button Text Color                | Leave Blank                                                                                     |
| Button Background Color          | Leave Blank                                                                                     |
| AfterPay Min (per your contract) | 0 *Unless otherwise specified by Afterpay*                                                      |
| AfterPay Max (per your contract) | 1000 *Unless otherwise specified by Afterpay*                                                   |
| Widget Logo Color                | Select Colour as the default option. Black or White is only approved for certain circumstances. |
| Widget Background Color          | Left as default                                                                                 |
| Widget Text Color                | Left as default                                                                                 |
| Widget Position                  | Target Existing Element and Show Next to it                                                     |
| Widget Target Element            | .price *Ensure you include the period (.) at the start of price*                                |
| Widget Target Action             | Insert After Target                                                                             |

\*If non-recommended options are used, this may result in Afterpay requesting you to update the settings to meet the Afterpay Branding or Integration Guidelines.

[Retailer Resources](www.afterpay.com/en-AU/retailer-resources)

Example of the APP Configuration Panel completed.

![Lightspeed-7.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/e899ed6554378e597e10339096e9e6e6507733846ba79d5855dededc9f712ecb/afterpay-online-dev-docs-1/assets/images/Lightspeed-7.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=a2c4fe6801d9c6aa75e464fa9430a66c9d8fff970821f612ad793205282e7f09&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

## Page Settings

These can all be left blank.

|                   |             |
| :---------------- | :---------- |
| Logo URL          | Leave blank |
| Background Color  | Leave blank |
| Custom CSS        | Leave blank |
| Text Color        | Leave blank |
| Custom Javascript | Leave blank |

Here is an example of how the Page Settings will look

![Lightspeed-8.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/ad26f70242c2682849f0b8516d38f8253bee8d1e4295d87475bdf47576822ee3/afterpay-online-dev-docs-1/assets/images/Lightspeed-8.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=adf12892e6b841ed84981bb3ca3e3f6411a5622e06a1965fd5fcdc5a241695e5&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

## Final Steps

Once all details have been entered:

1. Scroll to the bottom and click 'Save Settings'

2. Scroll to the bottom again and click 'Check Install (Publish Changes)'.

A banner appears advising the Install has been checked.

![Lightspeed-9.png](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/afterpay.docs.buildwithfern.com/53e12a160210df21c75f6d7fe8909276f9f9d19e5ef8f71a90567b825af7512c/afterpay-online-dev-docs-1/assets/images/Lightspeed-9.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260921%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260921T105635Z&X-Amz-Expires=604800&X-Amz-Signature=7a3dc7309cff48277da126486bda065b452215586d9e79a05cee62e7064db999&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Afterpay should now be installed and available for use by your customers.

Afterpay should also appear on the Product Pages and as a payment option on the Checkout Page.