---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/saas/Shopify/card/index.md
description: >-
  Shopify x PingPong Checkout international card embedded installation guide,
  suitable for merchants who wish to integrate PingPong payment solutions in
  their Shopify stores. This guide covers the entire process from searching and
  installing the APP to completing testing and closing the original checkout,
  ensuring merchants can smoothly access international credit card payment
  functions and support global transaction processing.
---
## International Card Embedded Installation Guide

### Step 1. Search APP

Click this link (<https://apps.shopify.com/credit-card-1>) to install the APP.

::: warning Note
Please install through the specified link, do not search directly in the Shopify app market.
:::

<v4-iImage src="/v4/saas/shopify/v5/card-step1-app-store.png" name="Figure 1 - App Store Search"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/card-step1-app-detail.png" name="Figure 2 - APP Detail Page"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/card-step1-install-page.png" name="Figure 3 - Installation Page"></v4-iImage>

### Step 2. Install APP

Click 【**Install**】-->【**Link SHOPIFY and PingPong Checkout**】-->Select 【**Registration Entity**】-->【**Confirm**】

::: warning Note
Please be sure to select the **entity region** according to the **company entity registered in PingPong Checkout**, otherwise it will affect the binding. Other entities refer to entities other than US entities that can be selected, such as HK/SG, etc.
:::

<v4-iImage src="/v4/saas/shopify/v5/card-step2-install-click.png" name="Figure 4 - Click Install"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/common-select-entity.png" name="Figure 5 - Select Registration Entity"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/common-login-page.png" name="Figure 6 - Login Page"></v4-iImage>

Please log in using your administrator email and password used during registration.

Default login name: **admin**

### Step 3. Select Binding Website

Select the website you want to bind-->click 【**Agree and Authorize**】, it will automatically redirect to the Shopify page.

::: warning Note
- Currently the system does not support batch binding of multiple websites, each needs to be operated individually
- This page only displays **websites that have been approved**
:::

<v4-iImage src="/v4/saas/shopify/v5/common-select-site.png" name="Figure 7 - Select Binding Website"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/common-authorize.png" name="Figure 8 - Agree and Authorize"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/common-redirect-success.png" name="Figure 9 - Redirect Success"></v4-iImage>

### Step 4. Activate Payment Method

After completing the binding and redirecting back to the Shopify admin backend, check the required payment methods, click 【**Activate**】-->【**Save**】.

::: warning Note
Do not check Test mode, otherwise it will submit to the test environment.
:::

<v4-iImage src="/v4/saas/shopify/v5/card-step4-activate.png" name="Figure 10 - Activate Payment Method"></v4-iImage>

### Step 5. Set Required Fields

Set Email and name as required fields, otherwise it will affect transaction success, need to set according to the following screenshots.

<v4-iImage src="/v4/saas/shopify/v5/card-step5-email-settings.png" name="Figure 11 - Email and Name Required Settings"></v4-iImage>

### Step 6. Installation Success

After successful installation, your merchant backend and checkout will display the corresponding payment icons/entry.

<v4-iImage src="/v4/saas/shopify/v5/card-step6-backend-success.png" name="Figure 12 - Backend Display Success"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/card-step6-checkout-success.png" name="Figure 13 - Checkout Display Success"></v4-iImage>

### Step 7. Test Verification

After the APP is successfully installed, please set up a product link with an amount of **1 USD** for the operations team to test, or the merchant can test a transaction themselves. After successful testing, it can be officially launched for use.

### Step 8. Close or Uninstall Original Checkout

::: note Tip
New merchants can ignore this step.
:::

After the PingPong Checkout embedded checkout is successfully tested, the original collection checkout can be closed, the specific operation is as follows:

#### If only integrated international cards from PingPong Checkout

Enter the Shopify admin backend, select 【**Settings**】-【**Payments**】, click 【**PingPong Checkout**】to enter, scroll down and click 【**Deactivate**】directly.

<v4-iImage src="/v4/saas/shopify/v5/card-step8-deactivate-entry.png" name="Figure 14 - Close Entry"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/card-step8-deactivate-button.png" name="Figure 15 - Click Deactivate"></v4-iImage>

#### If both international cards and local payment methods from PingPong Checkout are integrated

You can install local payment checkout according to the [Local Payment Checkout Mode Integration](/en/notes/saas/Shopify/apm/), some local payment methods already support tiling, you can install the supported tiling payment methods according to the corresponding links.

::: warning Note
If you have previously installed credit card embedded APPs from other partners, you need to uninstall them before installing PingPong Checkout's credit card embedded.