# Shopify Plus App

*Our Shopify Plus standardises AU, NZ and international addresses in real-time using Shopify Plus Checkout extensions.*

***

### Prerequisites

1. Have Shopify Plus platform installed.
2. Have an active Loqate Harmony API Account. You can sign-up for [free trial here](https://www.loqate.com/anz/register/).
3. Contact Support or Account Manager to get the Custom App.

### Custom App - Install

1. Get the app link from Loqate Support then paste into your browser that is logged into your store. One app link per organisation can have many Stores.
2. Review App permissions and press install

<figure><img src="/files/UrXeHDmnH5AnB4jC80p8" alt=""><figcaption></figcaption></figure>

### Set-up API Key for Shopify Plus

1. You will need a your Harmony API keys (see [getting your api keys](/loqate-harmony-api/guides/console/getting-your-api-keys.md).) Then base64 encode these keys.&#x20;
2. Your user will need domain extensions.shopifycdn.com added to key. See ([allowlisting domain](/loqate-harmony-api/guides/console/subscriptions/allowlisting-domains.md))
3. To base64 encode username and password in format '{user}:{password} or Contact support who can supply you with this.
4. Enter your base 64 encoded keys into the Loqate API Key section

<figure><img src="/files/zCMpTRTSKRG1MBaP6i2E" alt=""><figcaption></figcaption></figure>

### Configure each store&#x20;

Each store requires manual configuration to ensure other solutions do not interfere with performance of Loqate Harmony solution.&#x20;

1. ***Select Checkout on left navigation and scroll down***

<figure><img src="/files/LlwWG5DZp2JRa3qQkcEa" alt=""><figcaption></figcaption></figure>

2. &#x20;***Uncheck the 'Validate shipping address' option.***

<figure><img src="/files/q5Prn3InDoZoJUNYyBv1" alt=""><figcaption></figcaption></figure>

3. &#x20;***Navigate to top and this time go into Store Customize***

<figure><img src="/files/BS52mkxDDVbt1oVoqFTV" alt=""><figcaption></figcaption></figure>

4. &#x20;***Scroll down the left have options until you reach 'Address autocompletion' and disable it.***

<figure><img src="/files/4ubBY8VpKSzuR0QGmDjr" alt=""><figcaption></figcaption></figure>

5. ***Ensure you have added the loqate-checkout  app block.***

<figure><img src="/files/AXtx7D2v6QqKMe8wl6W5" alt=""><figcaption></figcaption></figure>

### Testing your Installation

You are now ready to test connectivity within your store.

If you need to configure requests this can be done by contacting support.

### Configuration of requests

You can still use all our API settings (featureOptions). For Shopify Plus these are set in our API by our service team.&#x20;

For example using:

* Dataset / SOT per country - Basic or Pro
* [AU Parcel Lockers](/loqate-harmony-api/guides/parcel-locker-plus.md)
* [Derived sub-premise feature](/loqate-harmony-api/guides/user-derived-address.md)

See all [Address featureOptions ](https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification/address/address-validation-and-lookup#/request)here for particular services.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mastersoftgroup.com/loqate-harmony-api/integrations/shopify-plus.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.