> This page is for Afterpay Online Developer, version Main (default).
> For other versions, use one of these documentation indexes:
> - Main (default): https://developers.afterpay.com/afterpay-online-developer/main/llms.txt
> - v1: https://developers.afterpay.com/afterpay-online-developer/v-1/llms.txt
> - Chinese: https://developers.afterpay.com/afterpay-online-developer/chinese/llms.txt

> 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.

# Lightspeed

## Afterpay Gateway Configuration

## Install Afterpay APP

Complete the steps below to enable Afterpay as a payment method and to display the Afterpay assets on the product pages.

1. Login to your eCommerce Store.

![lightspeed-1.png](/_fern-img/5715699a33e990d955c980a4d3ddb16ea5bd530cffc5e12aea86864e7ed3ae1a.webp)

2. Navigate to *Apps*.

![lightspeed-2.png](/_fern-img/3dc77657ccbf6d700873b3d54bca3f744dd523687405a7b43433d5dd95338c29.webp)

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

4. Click **Install**.

5. You are asked to *Install Afterpay Payment Integration*.

6. Enter your website username/password and click **Next**.

![lightspeed-3.png](/_fern-img/e7379305321c6eca8f8736a0f07d27ff69656bc658e24025fb95fbc517e0e857.webp)

7. Notification of Plugin required access appears. Review the access requirements and click **Grant Access**.

![lightspeed-4.png](/_fern-img/5a6931e43526f2a050d7c5bbead845dda1fc39d14a13535b31f102ade5eb845c.webp)

8. Login or create a new AdVision Lightspeed eComm App account, if you do not have one.

9. Once you have an account, login to it.

![lightspeed-login.png](/_fern-files/afterpay.docs.buildwithfern.com/eceb96b9e27549cb1d9687716f1577052b1f002738d69d2ea2dda9036c40011f/afterpay-online-dev-docs/assets/images/lightspeed-login.png)

10. You are redirected to the Afterpay Payment Gateway settings page. If not, Navigate to *Apps > Purchased Apps > Afterpay Payment*.

## App Configuration

If you are not already on the configuration panel, to get to your Afterpay APP configuration panel do the following:

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) | 2000 *Unless otherwise specified by Afterpay*                                                        |
| Widget Logo Color                | Select *Colour* as the default option. Black or White is only approved for certain circumstances.(1) |
| 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 *please ensure you include the full stop. at the start of price*                              |
| Widget Target Action             | Insert After Target                                                                                  |

(1) If you deviate from the recommended options listed above, Afterpay may request updates to the settings to meet Afterpay branding guidelines. For more information, see the
[Retailer Resources](https://www.afterpay.com/en-AU/retailer-resources)

Here is an example of the completed APP Configuration Panel:

![lightspeed-5.png](/_fern-img/e899ed6554378e597e10339096e9e6e6507733846ba79d5855dededc9f712ecb.webp)

## Page Settings

These can all be left blank.

| Name              | Setting     |
| ----------------- | ----------- |
| 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-6.png](/_fern-img/ad26f70242c2682849f0b8516d38f8253bee8d1e4295d87475bdf47576822ee3.webp)

## Final Steps

Once all details have been entered, do the following:

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.

Afterpay should now be installed and available for use by customers.\
Afterpay should also appear on the product pages and as a payment option on the checkout page.

> **Supported Countries**
>
> Afterpay is available for Lightspeed merchants with a store in these countries:
>
> * 🇦🇺   Australia