HomeDocumentationAPI Reference
Documentation

Shopify Payments / Shop Pay - US Guide

This guide will walk you through setting up an extension store on Shopify using the Reach Embedded solution.

> 🚧 Some sensitive information has been removed from screenshots and will be provided as-needed by your onboarding team at Reach.

# <p style={{ color: '#6158fb' }}>Part One</p> Setup API for remittance data.

Our first step is to install an API into your Shopify account to ensure smooth reporting and remittance on Reach’s end. Follow these easy steps to complete the process:

## <p style={{ color: '#6158fb' }}>Step 1.</p>

Navigate to **Settings > Apps and Sales Channels**

## <p style={{ color: '#6158fb' }}>Step 2.</p>

Click **“Develop Apps”** in the top-right corner.

![](https://files.readme.io/87198d50c40f2d7fc03831b3066286e49f285015798ab447f39d050b1dabe467-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Step 3.</p>

Once clicked, the screen will change - click **“Create an app”** in the top-right corner.

## <p style={{ color: '#6158fb' }}>Step 4.</p>

This should pop up a modal window. You can enter a name for the app, we suggest **“Reach Data.”**

![](https://files.readme.io/f92a890a0faace05c8d414e58533fb9ba563ffec75830f1ab181f24e0d71fff3-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Step 5.</p>

This will now take you to an overview page. 

• From tabs at the top, click **“Configuration”**

• Under Admin API access scopes search and click the checkboxes of:

*<p style={{ color: '#6158fb' }}>read\_orders\
read\_products\
read\_shopify\_payments\_payouts\
read\_shopify\_payments\_disputes\
read\_shopify\_payments\_accounts\
read\_shopify\_payments\_bank\_accounts</p>*

• Scroll to the bottom and click **“Save”**

![](https://files.readme.io/c23bed62f50907dadf2b253ed09598136cb689a5f72a3eb2816ae63503d7fa9d-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Step 6.</p>

Navigate to API Credentials from the tabs on the top.

• Click **“Install App”**

## <p style={{ color: '#6158fb' }}>Step 7.</p>

You will then be provided with an API Access Token and API Keys\
• Click **“Reveal token once”**\
• Copy the following and send to your Reach representative

*<p style={{ color: '#6158fb' }}>Admin API access Token\
   API Key\
   API Secret Key</p>*

![](https://files.readme.io/57fc1ad46ec656f7796d418382291232dd13b749420633c9007066a1e52a320c-image.png)

<br />

# <p style={{ color: '#6158fb' }}>Part Two</p> Go-live call with Reach.

> ❗️ IMPORTANT
>
> The following steps should not begin until your scheduled Go-Live call with Reach.

## <p style={{ color: '#6158fb' }}>Begin entity change.</p>

• Please being by going to **Settings > Payments**

• **Deactivate** existing Shopify Payments.

• Now, you will be able to change your store’s billing information.

![](https://files.readme.io/787af215c6f7fa07442a6f4879dfb3b29698abaf9977efdfaff527e672e46e28-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Store entity & address.

Change all following business information in **Settings > Store Details**

<p style={{ color: '#6158fb' }}>Legal business name</br>  
Country/region </br> 
Address  </br> 
City </br> 
State/territory</br> 
ZIP code</p>

> 🚧 This information will be provided securely by your Reach onboarding team.

![](https://files.readme.io/76470e127322edac253eb8758c74162400bce22b8f380feb72d37140b60ea3bc-image.png)

> 📘 Note that once the currency is changed, the prices must be updated to the new store currency in order to not lose out on the exchange rate.

# <p style={{ color: '#6158fb' }}>Part Three</p> Activate Shopify Payments.

With your store’s billing information updated, it is time to re-activate Shopify Payments.

## <p style={{ color: '#6158fb' }}>Step 1.</p>

Navigate to ***Settings > Payments*** and click “Activate Shopify Payments.”

![](https://files.readme.io/0ccbeff0f9ea03186c19adc7ad914c00bc749e8fcef72dfbe42cb906625707da-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Step 2.</p>

If it is checked by default, please ***uncheck*** the box ***“I am doing business as an individual or sole proprietor.”***

![](https://files.readme.io/26b15929b0726842f87091eab6f85bbe299a4964978aa033569a0dd7b5856339-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Business Type

Change the business type to **"Corporation."**

![](https://files.readme.io/cca412dda092f47eb5ac57b4430b7e99781a57fc0816dd3a95ea767ece9aaa60-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Business Details

Change all following business information under **"Business Type."**

<p style={{ color: '#6158fb' }}>
Registered business name </br> 
Employer Identification Number (EIN) or Social Security Number (SSN)
 </br> 
Street Address</br> 
City</br>
ZIP code</br>
Doing business as (Optional)</br>
State</br>
</p>

> 🚧 This information will be provided securely by your Reach onboarding team.

![](https://files.readme.io/8ada9c45e80b180fc9a8eeccc482f9340f4e05a5f2e417d85b6c1a1371432d15-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Store Industry Info

Change all following business information under **"Business Type."**

<p style={{ color: '#6158fb' }}>
Category •
[Your Business Category]</br> 
Sub-category •
[Your sub-category]</br> 
Description of products or services •
[Your product or service description]</br> 
Store Phone Number •
[Your store/customer service number]</br>
</p>

![](https://files.readme.io/017cd2c2df25ff5b24b8856a020958bd174726df2967dab2f6e4ac2310fd191a-image.png)

## <p style={{ color: '#6158fb' }}>Account Representative

Enter all other information as detailed under **"Account Representative"**

Check the two boxes highlighted in the screenshot.

<p style={{ color: '#6158fb' }}>First name / Last name</br>  
Equity </br> 
Date of birth (mm/dd/yyyy)</br> 
Job role</br> 
Social Security Number (SSN)</br>
Email</br>
Phone Number</br>
Address</br>
City</br>
Postcode</br>
Country/region</br>
Province</br>
</p>

> 🚧 This information will be provided securely by your Reach onboarding team.

![](https://files.readme.io/c6d36c5f3aeefb40e5f553eb114de77a8d5f15fed47546c9fdffa10193bf567f-image.png)

![](https://files.readme.io/a73500b89a94a8c842cd0cbfc900417c313a65bb1e27c0d003e098549af3904b-image.png)

## <p style={{ color: '#6158fb' }}>Equity ownership

• Click **"add another equity owner"** as indicated.

• Enter all other information as detailed in the screenshots. 

<p style={{ color: '#6158fb' }}>First name / Last name</br>
Email</br>
Ownership percentage</br> 
</p>

> 🚧 This information will be provided securely by your Reach onboarding team.

![](https://files.readme.io/6dda5c5d20b449fac4257a6580050f967f3fc0c8a50e37c1bc249f39df68e3e8-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Confirm information

Carefully confirm all business information and click **"Confirm"** when finished.

![](https://files.readme.io/c654a5a10e7158dd557f27cb7780dc204b8c953edf8288ba24e4edf26555b9ed-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Verify ownership

Carefully confirm all ownership details and click **"Confirm"** when finished.

![](https://files.readme.io/4ccaa8a17e165b21a1cf927e31f67c1025a118897818b48169e50112292e403e-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Agree to terms & submit

After carefully ensuring everything is correct, click **"Submit for Verification"** and then **"Agree"** to the terms.

![](https://files.readme.io/670bcdbae7112f62b32c9022d772cbc2f8117ebff95fc4805881612022e8309f-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Payout & Customer billing statement

Enter all other information as detailed.

• **Payout Statement name**

<p style={{ color: '#6158fb' }}>[Your Merchant Name]</p>

• **Payout every**

<p style={{ color: '#6158fb' }}>[business day]</p>

• **Customer billing statement - Statement Name**\
Enter information as provided by your Reach representative on the go-live call.

<p style={{ color: '#6158fb' }}>RCH-[your desired descriptor]</p>

• **Phone number**\
Enter information as provided by your Reach representative on the go-live call.

<p style={{ color: '#6158fb' }}>[Your number]</p>

![](https://files.readme.io/2d19b34f6976bd77442cbd4daecd8a6fa195ab894b1164a9a981cb65e2843c22-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Complete bank setup

Once you click **“continue account setup”**, you will need to proceed to the next step to add a bank account for deposits. 

Open **Add your banking information** and click on **“Add bank account”** for the next steps.

![](https://files.readme.io/9ee080d0927f802342aeab1ef4cc1760add6753c8b2cae44b489e999e745bf75-image.png)

<br />

## <p style={{ color: '#6158fb' }}>Banking information

Enter information as provided by your Reach representative on the go-live call.

<p style={{ color: '#6158fb' }}>Routing Number</br> Account Number</p>

> 🚧 This information will be provided securely by your Reach onboarding team.

![](https://files.readme.io/fced837d910d953a46993309a79dfabd8a4a4c496f95fa371038992ed434a8ed-image.png)

## <p style={{ color: '#6158fb' }}>Shop Pay

Shop Pay comes bundled with your Shopify payments activation. You can enable or disable this easily via the **manage payment method** button.

![](https://files.readme.io/9eabb85e1121fd3c0ada7c3a23a79a959128006089792f9c1fd9c765a61ece62-image.png)

<br />

<br />

# <p style={{ color: '#6158fb' }}>Part Four</p> PayPal setup.

To use Reach’s local acquiring solution through PayPal on your Shopify storefront, **you will need to contact your Reach representative in order to work through this process together.**

Begin by going to **Settings > Payments**, and under Supported payment methods, click **“Activate PayPal.”** A new browser tab will open to input PayPal credentials.

## <p style={{ color: '#6158fb' }}>Step 1.</p>

**Enter credentials.** Your Reach representative will provide you login details for localized PayPal processing.

## <p style={{ color: '#6158fb' }}>Step 2.</p>

**2-factor authentication.** Once logged in, there will be an authentication code to input that refreshes every 30 seconds.

## <p style={{ color: '#6158fb' }}>Step 3.</p>

**Setup complete.** Log out of the PayPal browser tab and your setup is complete!

![](https://files.readme.io/14a45d7e3c2f8597c8d4f3ad68cd1811ceb6a722acba478b3b336e1ad2501909-image.png)

<br />

# <p style={{ color: '#6158fb' }}>Part Five</p> Terms & conditions

<br />

**Merchant of Record requirements**

By deploying this solution, Reach will be acting as your Merchant of Record. There are legal requirements from our processing partners that we strictly adhere to, such as the Terms & Conditions laid out by our partnership with the merchant. 

[Please visit this link to read our Terms & Conditions](https://docs.withreach.com/docs/reach-embedded-terms-of-service) and follow the steps outlined to easily place them on your website - these must be accessible from a link in the footer of your website.