# 连接你的 Airwallex 账户

> 用你自己的 Airwallex 账户收取银行卡，以及 Alipay、WeChat Pay、GrabPay 和 FPX 等本地支付方式的付款。在 设置 > 支付 中点击 设置 Airwallex，粘贴 Client ID 和 API key，在 Airwallex 中添加我们的 Webhook URL 并粘贴它的密钥，选择 演示 或 正式，开启后点击 保存设置。

帮助中心 / 支付 - 更新于 2026年11月19日

Airwallex 是面向亚太、欧洲和北美商户的支付服务商。连接你的 Airwallex 账户后，顾客可以用银行卡，或你在 Airwallex 中开启的本地支付方式付款，例如 Alipay、WeChat Pay、GrabPay、FPX 和 PayNow。款项直接进入你的 Airwallex 账户，Shoprocket 收取 0%。

顾客点击 **立即支付** 后，Airwallex 的安全支付表单会直接在你的结账页面内打开。顾客无需离开你的店铺，就能在那里完成付款。卡信息直接发送给 Airwallex，不会经过 Shoprocket。

## 开始之前

你需要一个已开通在线支付的 Airwallex 账户，还需要三样东西：

1. 一个 **Client ID** 和 **API key**。在 Airwallex 中前往 **Developer > API keys**，创建一个受限密钥。只授予它 **Payment Acceptance** 的读写权限，不要授予其他权限。Airwallex 只会显示一次 API key，所以请立即复制。
2. 一个 **Webhook 密钥**。你要在 Airwallex 中用 Shoprocket 提供的网址创建 Webhook，所以会在下面的设置步骤中拿到这个密钥。
3. 知道你的密钥来自 **演示** 账户（用于试用）还是 **正式** 账户。

## 连接 Airwallex

1. 在后台中，前往 **设置 > 支付**。
2. 在 **支付网关** 中 Airwallex 的卡片上，点击 **设置 Airwallex**。
3. 把你的 **Client ID** 和 **API key** 粘贴到同名字段中。
4. 在 **Environment** 下，演示账户的密钥请选择 **演示**，正式账户请选择 **正式**。
5. 复制字段下方显示的 **Webhook URL**。
6. 在 Airwallex 中，前往 **Developer > Webhooks**，用该网址添加一个 Webhook。订阅 **Payment Intent** 和 **Refund** 事件，然后保存。
7. 随后 Airwallex 会显示这个 Webhook 的密钥。把它复制到 Shoprocket 的 **Webhook secret** 字段中。
8. 把 Airwallex 的开关切换为 **开启**，然后点击 **保存设置**。

![设置 > 支付 中的 Airwallex 卡片：Client ID、API key、Webhook 密钥和环境字段，下方是可复制的 Webhook URL](https://shoprocket.io/img/help/connect-airwallex/airwallex-setup.webp)

保存时，Shoprocket 会用你的 Client ID 和 API key 登录 Airwallex。如果 Airwallex 拒绝，就不会保存任何内容，屏幕顶部的消息会说明原因。最常见的错误是选错了环境。演示密钥只能用于 **演示**，正式密钥只能用于 **正式**。

随后卡片会显示 **已连接**，Airwallex 会出现在你的结账页面中。

## Webhook 为什么重要

有些付款方式会在顾客离开结账页面之后才完成，例如在银行 App 中支付的二维码。Airwallex 会通过 Webhook 把每笔付款和退款告知 Shoprocket。Shoprocket 会先向 Airwallex 核实这笔付款，再把订单标记为已付款。你在 Airwallex 中办理的退款，也是通过 Webhook 显示到 Shoprocket 的订单上。

银行卡付款即使没有 Webhook 也会立即确认，但请在开始销售之前先添加它。

## 你可以收取的币种

保存时，Shoprocket 会读取你的 Airwallex 账户支持银行卡收款的币种。如果顾客用你的账户不支持银行卡的币种结账，这笔付款就无法通过 Airwallex 完成。结账页面会请他们选择其他付款方式。要支持更多币种，请先在 Airwallex 中开启它们，然后在 Shoprocket 中重新保存你的 Airwallex 凭据。

如果你的账户只支持一种币种的银行卡收款，而你的店铺使用另一种币种标价，卡片会提醒你。你仍然可以把 Airwallex 提供给用该币种付款的顾客。方法是在 **按币种设置银行卡网关** 下添加该币种，详见 [选择支付网关](https://shoprocket.io/zh/help/choose-a-payment-gateway.md)。

## 用演示模式试一试

Airwallex 为你提供带有独立密钥的演示账户。要在不动用真钱的情况下试用结账，请选择 **演示** 并粘贴演示密钥。这时卡片会显示 **测试凭据：不会动用真钱**。Airwallex 的文档中列出了可以使用的测试卡号。

准备好开始销售时，点击 **编辑 Airwallex 凭据**，粘贴正式的 Client ID 和 API key，选择 **正式**，并粘贴你在正式账户中创建的 Webhook 的密钥。然后点击 **保存设置**。

## 顾客如何付款

- **银行卡**：顾客在你结账页面内的 Airwallex 表单中输入卡信息。如果他们的银行需要核实付款，核实也会在那里打开。如果银行卡被拒绝，他们可以在同一个表单中换一张卡再试。
- **本地支付方式**：顾客在同一个表单中选择它，然后按步骤操作，例如扫描二维码或在 App 中批准付款。Airwallex 一通知 Shoprocket 付款已完成，订单就会确认。

如果顾客改变主意，可以点击表单下方的 **选择其他付款方式** 回到购物车。

Airwallex 目前还不支持 Apple Pay 和 Google Pay。

## 退款

当你为用 Airwallex 付款的订单退款时，钱会自动退回给顾客，可以全额退款，也可以部分退款。请参阅 [为订单退款](https://shoprocket.io/zh/help/refund-an-order.md)。退款会从你的 Airwallex 余额中扣除，所以请保留足够的余额来支付。

## 订阅

Airwallex 可以为订阅续费。顾客购买订阅时，所用的银行卡会保存在你的 Airwallex 账户中。之后每次续费，都会按订阅的周期从这张卡上扣款。

## 更改凭据或关闭

连接 Airwallex 后，它的按钮会显示 **编辑 Airwallex 凭据**。已保存的凭据以加密方式存储，不会再次显示。要保留它们，请让字段留空。要替换它们，请填写所有字段并点击 **保存设置**。

要停止提供 Airwallex，请把它的开关切换为 **关闭** 并点击 **保存设置**。你的凭据仍然保存着，所以可以随时重新开启。顾客已经开始的付款仍会完成。

## 相关文章

- [选择支付网关](https://shoprocket.io/zh/help/choose-a-payment-gateway.md)
- [为订单退款](https://shoprocket.io/zh/help/refund-an-order.md)
- [下测试订单](https://shoprocket.io/zh/help/take-a-test-order.md)

[在后台打开“支付”](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/zh/help/connect-airwallex
- Language: 中文 (zh)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-airwallex.md), [Deutsch](https://shoprocket.io/de/hilfe/airwallex-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-airwallex.md), [English](https://shoprocket.io/help/connect-airwallex.md), [Español](https://shoprocket.io/es/ayuda/conectar-airwallex.md), [Français](https://shoprocket.io/fr/aide/connecter-airwallex.md), [עברית](https://shoprocket.io/he/help/connect-airwallex.md), [हिन्दी](https://shoprocket.io/hi/help/connect-airwallex.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-airwallex.md), [Italiano](https://shoprocket.io/it/aiuto/collega-airwallex.md), [日本語](https://shoprocket.io/ja/help/connect-airwallex.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-airwallex-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-airwallex-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/airwallex-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-airwallex.md), [Português](https://shoprocket.io/pt/ajuda/conectar-airwallex.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-airwallex.md), [Русский](https://shoprocket.io/ru/help/connect-airwallex.md), [ไทย](https://shoprocket.io/th/help/connect-airwallex.md), [Türkçe](https://shoprocket.io/tr/yardim/airwallex-hesabi-baglama.md)
