---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/saas/Shopify/card/index.md
description: >-
  Shopify x PingPong Checkout 国际卡内嵌安装指南，适用于希望在 Shopify 商店中集成 PingPong
  支付解决方案的商户。该指南涵盖了从搜索并安装 APP 到完成测试及关闭原有收银台的全过程，确保商户能够顺利接入国际信用卡支付功能，支持全球范围内的交易处理。
---
## 国际卡内嵌安装指南

### Step 1. 搜索 APP

点击此链接 (<https://apps.shopify.com/credit-card-1>) 安装 APP。

::: warning 注意
请通过指定链接安装，不要在 Shopify 应用市场直接搜索。
:::

<v4-iImage src="/v4/saas/shopify/v5/card-step1-app-store.png" name="图1 - 应用商店搜索"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/card-step1-app-detail.png" name="图2 - APP 详情页"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/card-step1-install-page.png" name="图3 - 安装页面"></v4-iImage>

### Step 2. 安装 APP

点击【**Install**】-->【**关联 SHOPIFY 和 PingPong Checkout**】-->选择【**注册主体**】-->【**确认**】

::: warning 注意
请务必按照在 **PingPong Checkout 注册的公司主体**选择**主体地区**，**否则会影响绑定**。其他主体指除美国主体之外的其他主体可选择，如 HK/SG 等。
:::

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

<v4-iImage src="/v4/saas/shopify/v5/common-select-entity.png" name="图5 - 选择注册主体"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/common-login-page.png" name="图6 - 登录页面"></v4-iImage>

请使用您注册时的管理员邮箱及密码进行登录。

登录名默认：**admin**

### Step 3. 选择绑定网站

选择您要绑定的网站-->点击【**同意并授权**】，会自动跳转到 Shopify 页面。

::: warning 注意
- 目前系统不支持批量绑定多个网站，需要逐个进行操作
- 此页面仅展示**已审核通过的网站**
:::

<v4-iImage src="/v4/saas/shopify/v5/common-select-site.png" name="图7 - 选择绑定网站"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/common-authorize.png" name="图8 - 同意并授权"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/common-redirect-success.png" name="图9 - 跳转成功"></v4-iImage>

### Step 4. 激活支付方式

完成绑定并跳转回 Shopify 管理后台，勾选需要的支付方式，并单击【**Activate**】-->【**Save**】。

::: warning 注意
Test mode 不勾选，否则会提交测试环境。
:::

<v4-iImage src="/v4/saas/shopify/v5/card-step4-activate.png" name="图10 - 激活支付方式"></v4-iImage>

### Step 5. 设置必填项

Email 和 name 设置为必填项，不然会影响交易成功，需要根据以下截图设置勾选。

<v4-iImage src="/v4/saas/shopify/v5/card-step5-email-settings.png" name="图11 - Email 和 Name 必填设置"></v4-iImage>

### Step 6. 安装成功

安装成功后，您的商户后台和收银台会显示对应的支付图标/入口。

<v4-iImage src="/v4/saas/shopify/v5/card-step6-backend-success.png" name="图12 - 后台显示成功"></v4-iImage>

<v4-iImage src="/v4/saas/shopify/v5/card-step6-checkout-success.png" name="图13 - 收银台显示成功"></v4-iImage>

### Step 7. 测试验证

APP 安装成功后，请设置一个金额为 **1 美元**的商品链接给运营团队进行测试，或商户侧可自行测试一笔。测试通过后，即可正式上线使用。

### Step 8. 关闭或卸载原有收银台

::: note 提示
新商户接入，可忽略此步骤。
:::

PingPong Checkout 内嵌收银台测试成功后，可将原来的集合收银台关闭，具体操作如下：

#### 若只对接了 PingPong Checkout 的国际卡

进入 Shopify 管理后台，选择【**Settings**】-【**Payments**】，点击【**PingPong Checkout**】进入，往下拉直接点击【**Deactivate**】即可。

<v4-iImage src="/v4/saas/shopify/v5/card-step8-deactivate-entry.png" name="图14 - 关闭入口"></v4-iImage>

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

#### 若同时接入了 PingPong Checkout 的国际卡和本地支付方式

可按照[本地支付收银台模式集成](/notes/zh/saas/Shopify/apm/)安装本地支付收银台，部分本地支付方式已支持平铺，可按照对应链接将已支持平铺的支付方式进行平铺安装。

::: warning 注意
若之前安装过其他合作商的信用卡内嵌 APP，需将其卸载后才能安装 PingPong Checkout 的信用卡内嵌。
:::