> ## 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**（马来西亚），每种方式均以当地货币计费。

<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 应用中批准付款，然后返回你的成功页面。

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

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK 是 Alipay 的香港版本，面向当地市场运营，并以港元结算。它与中国大陆的 Alipay 产品是不同的支付方式。

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

  <Accordion title="FPS (Hong Kong)">
    FPS（Faster Payment System）是香港的实时银行间转账网络，由香港金融管理局运营。客户直接从银行账户付款，转账会立即完成清算。

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

  <Accordion title="Touch 'n Go (Malaysia)">
    Touch 'n Go 是马来西亚占主导地位的电子钱包。客户在 Touch 'n Go 应用中确认付款，然后返回你的成功页面。

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

## 配置

### API 方式类型

| 类型           | 说明                     |
| :----------- | :--------------------- |
| `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)**，以便客户使用当地货币计费

<Warning>
  如果你使用其他货币定价且未启用 Adaptive Currency，这些市场的客户将不会使用当地货币计费，并且上述方式均不可用。
</Warning>

## 测试

<Steps>
  <Step title="Enable test mode">
    使用你的 Dodo Payments 测试 API 密钥。
  </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**。二维码会在全屏叠加层中打开，结账页面会等待付款完成。
  </Step>

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

<Note>
  测试模式二维码由电子钱包提供商的测试环境生成，其行为可能与真实付款不同。
</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 结账中同时提供这两种方式，以便 Dodo Payments 根据客户偏好呈现相应选项。
  </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. 是否已在 `allowed_payment_method_types` 中包含支付方式（`gcash`、`ali_pay_hk`、`fps` 或 `touch_n_go`）？
    5. 如果使用其他货币定价：是否已启用 Adaptive Currency？

    **解决方案：** 暂时移除 `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">
    **原因：** 这些方式会将客户重定向到电子钱包应用或银行应用。如果客户放弃操作，付款将保持未完成状态。

    **解决方案：** 监控 webhooks 以获取最终付款状态，而不要依赖返回重定向。请参阅 [Webhooks 指南](/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>