> This page is for Afterpay Online Developer, version v1.
> 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.

# 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](/_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

![Lightspeed-3.png](/_fern-img/3bf812e927d1c1e5fe84c719080f513f9611cb522f29f07b5d3684a2cb41f1e4.webp)

4. Click Install

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

   * Enter your Website Username/ Password

   * Click ‘Next’

![Lightspeed-4.png](/_fern-img/e7379305321c6eca8f8736a0f07d27ff69656bc658e24025fb95fbc517e0e857.webp)

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

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

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](/_fern-files/afterpay.docs.buildwithfern.com/eceb96b9e27549cb1d9687716f1577052b1f002738d69d2ea2dda9036c40011f/afterpay-online-dev-docs-1/assets/images/Lightspeed-6.png)

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](/_fern-img/e899ed6554378e597e10339096e9e6e6507733846ba79d5855dededc9f712ecb.webp)

## 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](/_fern-img/ad26f70242c2682849f0b8516d38f8253bee8d1e4295d87475bdf47576822ee3.webp)

## 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](/_fern-files/afterpay.docs.buildwithfern.com/53e12a160210df21c75f6d7fe8909276f9f9d19e5ef8f71a90567b825af7512c/afterpay-online-dev-docs-1/assets/images/Lightspeed-9.png)

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.