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

# Add Afterpay at Checkout

> **Important**
>
> There are two different Afterpay payment apps for Shopify—one for the United States, the other for the rest of the world. **This page is for merchants outside of the US.** If you're in the US, visit [this page](/afterpay-online-developer/guides/platforms/shopify/getting-started).
>
> Before you start, ensure that you have Shopify installed and working.

## Overview

The Afterpay integration process can be completed in three steps:

* [Download the Afterpay payment app](#download-the-afterpay-payment-app)

* [Connect your Business Hub account](#connect-your-business-hub-account)

* [Confirm and activate](#confirm-and-activate)

### Download the Afterpay payment app

Do the following:

1. Click [here](https://accounts.shopify.com/store-login?redirect=settings%2Fpayments/alternative-providers/1057655) to log in to Shopify and download the Afterpay app.
2. When the **Install app** screen appears, click **Install**.
   ![afterpay-shopify-paa-1-small.png](/_fern-img/9cede494b306d8feb6d26031133a0188fee3c8b32f041878b331e4a008a14777.webp)
3. Once installed, Afterpay appears in your list of apps.

### Connect your Business Hub account

After you've installed the Afterpay app,  you're automatically redirected to the Business Hub to verify your merchant account.

Follow these steps to connect your account:

#### Step 1: Log into Business Hub

If you're not already logged in, log into your Business Hub user account.

> **Important**
>
> If you have trouble accessing your Business Hub account, try [resetting your password](https://hub.us.afterpay.com/forgot-password). If you need an account to be created, contact your team's main internal onboarding contact.

#### Step 2: Select your merchant account

From the dropdown menu, select the merchant account that should be associated with your storefront. Ensure that it's the correct account for your specific Shopify store.

![Shopfiy\_1click\_ap](/_fern-img/72e68de8767a59923c3871138fbc9c49822c19bc3dfc4de27e48e24881b371b5.webp)

#### Step 3: Connect the account

Click the **Connect** button to link your Business Hub merchant account to Shopify. Once the connection is successful, you're automatically returned to Shopify.

### Confirm and activate

After successfully verifying your credentials, you return to Shopify. A screen appears with two toggle switches and a *More actions* menu. Do the following:

1. Activate the payment gateway. Keep **Test mode** inactive, and click **Activate**. This screenshot shows the result:

   ![ap-shopify-paa-5-small.png](/_fern-img/06889bf0834b774a505f7b782d9b614e14950515049b81771d4171f844a8c914.webp)

   > **Warning!**
   >
   > **Do not enable Test mode.** If you enable Test mode, the integration fails. The **Enable test mode** function is only for use on dedicated test websites. Contact your Afterpay Account Manager if you need test credentials.

2. Go to your online store and verify that Afterpay is a checkout option.

![final-small.png](/_fern-img/5eb2c845b06d37b365e0f3711b9f2fd5f75f994a1f5aa01ed4a9db7e35598459.webp)

## Manage your merchant integration

If you ever need to change which merchant account is connected to your Shopify store, follow these steps:

1. In your Shopify admin, go to **Settings**, then **Payments**.
2. Select the **Afterpay (New)** payment app.
3. Click **More actions**, then **Manage**. This takes you to the Business Hub, where you can select a different merchant account.
4. Choose the new account you want to use and click **Connect**.