How to connect your Shopify store with Chopify

Connect Shopify to your CardCorp payment gateway with Chopify.

---

📘

Chopify store settings

• The settings you configure for your Shopify Checkout do not apply to the Chopify Checkout.
• Always select the Live theme so your checkout will collect payments correctly
• Chopify will always charge the customer in the store currency

---

Prerequisites

1. Request your CardCorp payment gateway authentication credentials (Entity ID and Access Token) from the CardCorp Support Team. CardCorp provides separate entity IDs and access tokens for the test and live environments.
2. Use the Shopify Basic plan or higher for your store.

---

Create a custom app in Shopify

Create a custom app in Shopify for the Chopify connector.

1. Sign in to Shopify at https://admin.shopify.com/.

2. In the left sidebar, near the bottom of the page, select Settings.

3. Select Apps, then Develop apps.

   

4. Select Build Apps in Dev Dashboard.

5. Select Create app.

6. Under Start from Dev Dashboard, enter the App name, then select Create.

   

7. For the App URL, enter https://[subdomain].chopify.pro and replace [subdomain] with your store subdomain, for example, https://npv3yt-vu.chopify.pro.

8. For the Webhooks API version, select 2026-01.

   

9. For the Scopes, paste these values.

   Text

   read_customers,read_discounts,write_draft_orders,read_draft_orders,read_orders,write_orders,read_products,write_products,write_script_tags,read_themes,write_themes

10. For the Redirect URLs, enter https://[subdomain].chopify.pro/api/auth/callback and replace [subdomain] with your store subdomain, for example, https://npv3yt-vu.chopify.pro/api/auth/callback.

11. Under App proxy, for the Subpath prefix fro apps , enter the Subpath of cardcorp-checkout.

12. Set the Proxy URL to https://[subdomain].chopify.pro/proxy/cardcorp-checkout and replace [subdomain] with your store subdomain.

    

13. Select Release, then confirm your app details for this version.

---

Get the app credentials

1. In Settings, copy the Client ID and Secret. Send these credentials to CardCorp Merchant Services.

---

Install the app

1. From Settings, select the app name in the left menu.

2. Select Install app.

Or from outside the app settings, go to Settings > Apps. Select Develop apps, then select Build Apps in Dev Dashboard, and then select the app name and install.

---

CardCorp Merchant Services creates your connection

CardCorp Merchant Services registers your app credentials on the server before you configure the Chopify app. Confirm that registration is complete before you continue.

---

Configure the Chopify app for the test environment

Configure the Chopify app with your test credentials before you deploy it to your live store.

1. In Shopify Admin, go to Apps.

2. Select your app name, then select Settings.

3. Enter your Entity ID and Access Token for your test environment.

4. Clear the AMEX brand because that requires a separate connector in the gateway.

5. For Test Mode, select EXTERNAL.

   

6. Optional: If your store has a user area where customers can sign in, select Enable card registration to let your customers save cards.

7. For Deployment method, select Theme Asset, then select your Target theme, which is your Live theme.

8. In the top right corner, select Save.

9. Select Test connection and confirm that your credentials work. If the test fails, contact CardCorp Merchant Services to check they have registered your app credentials before you continue.

10. When your connection test passes, at the bottom of the page, select Deploy script.

---

Go live from your test environment

To switch to your live environment from your test environment, change the following settings.

1. Enter your Entity ID and Access Token for the live environment.
2. Change the Base URL to https://eu-prod.oppwa.com for the live environment with prod instead of test.
3. For Test Mode, select None (Production).
4. Select Save at the top of the page.
5. Select Test connection.

---

Configure the Chopify app for the live environment

To deploy directly in the live environment, configure the app with your live credentials to accept payments from your customers.

1. Go to Shopify Admin.
2. Select your app name, then click Settings.
3. Enter your Entity ID and Access Token for the live environment.
4. Enter the Base URL to https://eu-prod.oppwa.com for the live environment.
5. For Test Mode, select None (Production).
6. Select Save at the top of the page.
7. Select Test connection and confirm that your credentials work. If the test fails, contact CardCorp Merchant Services to check they have registered your app credentials before you continue.
8. Select Deploy script.

---

Delivery

Chopify supports delivery to the customer's shipping address only. Selecting additional delivery methods does not make them available to the customer.

---

Taxes

Chopify supports Shopify tax, Shopify basic tax, and manual tax. Include all taxes in the product price.

---

Refunds

Refund transactions from the CardCorp Hub with the following steps.

1. Sign in to the CardCorp Hub.
2. Follow the instructions at Refund a transaction.

---

Update your app

To make changes to your configuration, follow these steps.

1. Go to Versions
2. Select Create version
3. Edit the Settings.
4. Select Release, then confirm your app details for this version.