> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 亚太地区支付方式

> 在菲律宾接受 GCash，在香港接受 Alipay HK 和 FPS，在马来西亚接受 Touch 'n Go，支持一次性付款，并以各市场的本地货币结算。

让菲律宾、香港和马来西亚的客户使用他们日常使用的钱包或银行转账付款。Dodo Payments 支持一次性付款使用 **GCash**（菲律宾）、**Alipay HK** 和 **FPS**（香港）以及 **Touch 'n Go**（马来西亚）。每种方式均使用其本地货币结算，客户可在结账时扫描显示的 QR 码完成付款。

<Note>
  本页面介绍菲律宾、香港和马来西亚。有关其他亚洲市场，请参阅 [印度](/features/payment-methods/india) 了解 UPI 和 Rupay，参阅 [韩国](/features/payment-methods/south-korea) 了解 Kakao Pay、Naver Pay 和 PAYCO，以及参阅 [WeChat Pay](/features/payment-methods/wechat) 了解中国客户。
</Note>

## 为什么亚太地区电子钱包很重要

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    GCash 是菲律宾最受欢迎的数字钱包，而 Touch 'n Go 是马来西亚最大的电子钱包。
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    与以银行卡为主的市场相比，菲律宾的信用卡使用率较低。本地钱包和银行转账可以触达仅支持银行卡的结账流程无法覆盖的客户。
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS 在香港全天候运行，资金几乎可以立即到账，因此客户等待时，结账流程即可确认付款。
  </Card>
</CardGroup>

## 支持的方式

该表列出了每种方式的市场、结算货币和最低金额。最低金额是该货币的结账最低金额，因此适用于以该货币结账的所有付款方式。

| 方式 | 国家/地区 | 结算货币 | 订阅 | 最低金额 |
| :- | :- | :- | :-: | :- |
| **GCash** | 菲律宾 | PHP | 否 | 50.00 PHP |
| **Alipay HK** | 香港 | HKD | 否 | 4.00 HKD |
| **FPS** | 香港 | HKD、CNY | 否 | 4.00 HKD / 4.00 CNY |
| **Touch 'n Go** | 马来西亚 | MYR | 否 | 4.00 MYR |

<Warning>
  **这四种方式均仅支持一次性付款。** 它们不会出现在订阅结账中，也不支持任何其他定期扣款。在订阅结账中加入 `credit` 和 `debit`，以便这些市场的客户仍可注册。
</Warning>

<Info>
  客户使用本地货币付款。通过这四种方式完成的付款会结算到您的 **USD** 钱包。同一结账流程中的银行卡付款也会以 USD 结算。
</Info>

### 方式详情

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash 是菲律宾最受欢迎的电子钱包。在结账时，客户选择 **GCash**，点击 **Pay**，然后使用 GCash 应用扫描 QR 码以批准付款。

    适用于以 **菲律宾（`PH`）** 为结算国家/地区、以 **PHP** 结算的 **一次性** 结账。
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK 是 Alipay 的香港版本，服务于本地市场，并以港币结算。它与中国大陆的 Alipay 产品是不同的付款方式。结账时显示为 **AlipayHK**。

    适用于以 **香港（`HK`）** 为结算国家/地区、以 **HKD** 结算的 **一次性** 结账。Alipay HK 仅以 HKD 结算，因此不会出现在 CNY 结账中，即使结算国家/地区为香港也是如此。
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    FPS（Faster Payment System）是由香港金融管理局推出的香港实时支付系统。它连接银行和电子钱包，全天候运行，并支持港币和人民币。客户使用银行或电子钱包应用扫描 QR 码，资金几乎可以立即到账。

    适用于以 **香港（`HK`）** 为结算国家/地区、以 **HKD** 或 **CNY** 结算的 **一次性** 结账。
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    Touch 'n Go 是马来西亚最大的电子钱包。客户使用 Touch 'n Go 应用扫描 QR 码，然后在应用中确认付款。

    适用于以 **马来西亚（`MY`）** 为结算国家/地区、以 **MYR** 结算的 **一次性** 结账。
  </Accordion>
</AccordionGroup>

## 配置

### API 方式类型

在 `allowed_payment_method_types` 中传递以下值：

| 类型 | 描述 |
| :- | :- |
| `gcash` | GCash 钱包（菲律宾） |
| `ali_pay_hk` | Alipay HK 钱包（香港） |
| `fps` | FPS 实时银行转账（香港） |
| `touch_n_go` | Touch 'n Go 钱包（马来西亚） |

### 示例：菲律宾结账

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['gcash', 'credit', 'debit'],
  billing_currency: 'PHP',
  billing_address: {
    country: 'PH',
    zipcode: '1226'
  },
  return_url: 'https://example.com/success'
});
```

### 示例：香港结账

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ali_pay_hk', 'fps', 'credit', 'debit'],
  billing_currency: 'HKD',
  billing_address: {
    country: 'HK',
    zipcode: '999077'
  },
  return_url: 'https://example.com/success'
});
```

### 示例：马来西亚结账

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['touch_n_go', 'credit', 'debit'],
  billing_currency: 'MYR',
  billing_address: {
    country: 'MY',
    zipcode: '50450'
  },
  return_url: 'https://example.com/success'
});
```

### 要求

只有满足以下所有条件时，方式才会显示在结账中：

1. **结算国家/地区**与方式所属市场匹配：GCash 为 `PH`，Alipay HK 和 FPS 为 `HK`，Touch 'n Go 为 `MY`。
2. **结算货币**与方式匹配：PHP、HKD（FPS 也支持 CNY）或 MYR。
3. 结账类型为**一次性付款**，而非订阅。
4. 已启用 **[Adaptive Currency](/features/adaptive-currency)**。如果未启用，`billing_currency` 会被忽略，结账流程无法以 PHP、HKD、CNY 或 MYR 结算。

<Warning>
  如果停用 Adaptive Currency，这些市场的客户不会以本地货币结算，也不会显示上述任何方式。
</Warning>

## 测试

<Steps>
  <Step title="Enable test mode">
    关闭控制面板侧边栏中的 **Live Mode** 开关，并使用在测试模式下创建的 API keys。
  </Step>

  <Step title="Set the billing country and currency">
    使用待测试方式对应的结算地址国家/地区和结算货币创建一次性结账：

    | 方式 | 结算国家/地区 | 结算货币 |
    | :- | :- | :- |
    | GCash | `PH` | `PHP` |
    | Alipay HK | `HK` | `HKD` |
    | FPS | `HK` | `HKD` 或 `CNY` |
    | Touch 'n Go | `MY` | `MYR` |

    在 `allowed_payment_method_types` 中加入方式类型。这些方式不适用于订阅结账。
  </Step>

  <Step title="Select the method and confirm">
    在结账时选择付款方式并点击 **Pay**。QR 码会在全屏叠加层中打开，并显示 10 分钟倒计时；叠加层打开期间，结账流程会检查付款状态。
  </Step>

  <Step title="Verify the checkout behavior">
    确认该方式仅在匹配的国家/地区和货币下显示，并确认 QR 码能够正常呈现。
  </Step>
</Steps>

<Note>
  测试模式的 QR 码来自钱包提供商的测试环境，其行为可能与正式付款不同。
</Note>

## 最佳实践

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    在菲律宾和马来西亚，许多客户希望使用本地钱包付款。针对这些市场，在结账流程中将 GCash 或 Touch 'n Go 与银行卡并列展示。
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    Alipay HK 和 FPS 服务于不同类型的客户：钱包用户和银行转账用户。在 HKD 结账中同时加入这两种方式，让每位客户都能看到自己偏好的方式。
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    本页列出的每种方式都仅支持一次性付款，因此仅列出本地钱包的订阅结账没有可显示的方式。对于定期计划，请加入 `credit` 和 `debit`。
  </Accordion>

  <Accordion title="Match currency to region">
    这些方式要求使用本地结算货币。如果您的产品目录以 USD 或 EUR 定价，请启用 Adaptive Currency，以便向客户报价并使用 PHP、HKD、CNY 或 MYR 结算。
  </Accordion>
</AccordionGroup>

## 故障排除

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **检查：**

    1. 结算国家/地区是否为 `PH`、`HK` 或 `MY`，并与方式匹配？
    2. 结算货币是否为 PHP、HKD、CNY 或 MYR，并与方式匹配？
    3. 这是否为一次性付款？这些方式均不会出现在订阅中。
    4. 是否已将方式（`gcash`、`ali_pay_hk`、`fps` 或 `touch_n_go`）加入 `allowed_payment_method_types`？
    5. 是否已启用 Adaptive Currency？
    6. 金额是否达到 [Supported Methods](#supported-methods) 中规定的货币最低金额？

    **解决方案：** 暂时移除 `allowed_payment_method_types` 以查看所有符合条件的方式，然后找出未满足的条件。
  </Accordion>

  <Accordion title="Alipay HK missing on a CNY checkout">
    **原因：** Alipay HK 仅以 HKD 结算。在香港以 CNY 结算的结账中会提供 FPS，但不会提供 Alipay HK。

    **解决方案：** 使用 HKD 结算以提供 Alipay HK，或在香港的 CNY 结账中加入 `fps`。
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **原因：** GCash、Alipay HK、FPS 和 Touch 'n Go 仅支持一次性付款，不适用于定期扣款。

    **解决方案：** 在这些市场的订阅中使用 `credit` 和 `debit`。
  </Accordion>

  <Accordion title="Payment not confirming">
    **原因：** 客户必须扫描 QR 码，并在钱包或银行应用中批准付款。如果客户在批准前关闭应用，付款将保持未完成状态。

    **解决方案：** 使用 webhooks 获取最终付款状态，而不是依赖返回重定向。请参阅 [Webhooks guide](/developer-resources/webhooks)。
  </Accordion>
</AccordionGroup>

## 相关页面

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    查看所有支持的付款方式。
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    使用本地货币向客户收费，包括 PHP、HKD、CNY 和 MYR。
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    完整的结账实施指南。
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    测试数据和结账测试指南。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.