You need User or Hub Admin permissions in the Business Hub to verify your merchant account. Make sure you have the right permissions before trying to connect your Business Hub acount.
If you’ve already installed the Afterpay payment app, you’ll be redirected to the Business Hub to verify your merchant account.
If you’re having trouble signing in:
Use the Forgot my password link to reset your Business Hub password.
Contact your team’s main internal onboarding contact if you need general user account access created for the Business Hub
If you are still unable access the Business Hub, contact our Merchant Admin team by using the contact information below:
Email: anz-afterpay-merchant-admin@squareup.com
Please make sure to provide the following information so that we can promptly help you:
This can occur when a customer checks out with Afterpay without entering an email address.
To prevent this from happening you can go to your Shopify settings and select Customers can only check out using email.
See the Shopify Manual Capture topic.
Afterpay is currently unavailable on Shopify Express Checkout. If you navigate to the Payment Methods you should be able to view Afterpay.
If Afterpay is not visible on the Payment Methods, please contact your Afterpay Delivery Manager.
See the instructions on the Manually Add Afterpay Site Messaging to Theme page.
To display the Afterpay installment detail on the Shopify product pages, the active store theme is modified. When you change the Shopify theme, a new set of theme/template files is installed, which will not include the Afterpay product page display.
Although the product page display will require re-integration, Afterpay will remain active as a Payment Method on the Shopify checkout page.
To re-integrate the Afterpay product page display for the newly installed Shopify theme, please complete the steps outlined in the Afterpay site messaging topic.
To place a payment icon on the footer (bottom) of the payment page, first ensure that you have enabled payment icons in your footer.
Then do the following:
From your Shopify admin, go to Online Store and select Themes.
Select the theme you want to edit, then click the … button to open the Actions menu. Click Edit Code.
Open the Sections folder and click footer.liquid.
If your theme doesn’t include this file, click theme.liquid in the Layout folder.
Find the following code in the file:
Replace line 324 in the example with the following two lines of code:
Once you have made your replacement, the code should look like this:
Click Save
Verify on your live store.
The code examples above are in Liquid which is Shopify’s own code language.
If Afterpay messaging is already on your store and you would like to add a customizable Afterpay Banner, follow the instructions on the Add an Afterpay Banner to Shopify page.
A common cause for a customer being returned to the Shopify checkout page after trying to place an order with Afterpay is invalid order amount.
A customer’s Afterpay transaction will not be approved should the order total be:
In any of these cases the customer is returned to the Shopify checkout page.
Afterpay orders can be refunded from Shopify and are automatically sent to Afterpay.
You can learn how to do refunds here.
Please send an email with your request to:
🇦🇺 / 🇳🇿 merchantservices@afterpay.com.au
🇺🇸 / 🇨🇦 merchantAdminUS@afterpay.com
This occurs if the cart is modified after the customer is redirected to Afterpay to complete the order.
This issue has been resolved by Shopify’s latest Checkout Extensibility. If you are affected by this issue, it is likely that you still use Shopify’s older checkout platform, called checkout.liquid. According to Shopify, they will have contacted you about migration to the latest Checkout Extensibility platform. As the checkout.liquid platform will deprecate on August 13th 2024, we urge you to use Shopify’s latest checkout platform to avoid posssible problems.
Adding or subtracting units of any item to the cart, or even new items, changes the amount. The transaction on the Afterpay side now has a different amount than the amount in the merchant’s Shopify shop.
According to Shopify, payments apps must not do any of the following:
If the amount is different and the customer has paid less than the order at the Shopify shop, the order status automatically becomes Partially Paid.
You, the merchant, must make a manual action to fix the problem. Here are some ideas:
If the amount paid is less than the final order value, you can ask the customer to submit an extra payment. Ask the customer to use a different payment method to make this payment
If the amount paid is more than the final order value, you can make a partial refund to resolve the discrepancy
You can cancel the entire order, and refund the customer. Then ask the customer to place their order again, this time with the correct number of items in the cart
If this problem occurs regularly, please inform Shopify.
Shopify sellers manually placing the Onsite Messaging widget on their Product Detail and Cart pages can selectively hide the Onsite Messaging Widget for certain items.
Tag products you want to exclude (for example, no-afterpay) and insert a brief code snippet into your theme files where the <square-placement> tags are located.
This option is ideal for Shopify merchants who prefer to restrict the usage of Afterpay for specific products, including gift cards.
Product Detail page
Cart page
To use the Afterpay On-Site Messaging app, you must install the app from the Shopify app store. Configure this app according to your preferences. This setup includes customizing the appearance of on-site messages and ensuring the messages integrate with your store’s theme.
You can manually integrate Afterpay messaging into your Shopify theme. This process involves adjusting your theme’s HTML/Liquid files to include Afterpay’s messaging scripts at the desired locations on your product and cart pages. For details see the Manually Add Afterpay Site Messaging to Theme page.
There are several key steps to implement:
Ensure your store meets the technical requirements
Configure the app’s settings in your Shopify admin
Test the messaging display on your store to confirm that it functions correctly and reflects the intended customer experience.
For details on all the above steps, see the Afterpay On Site Messaging App page.