亚太地区支付方式

亚太地区的消费者使用本地电子钱包和实时银行转账结账的频率，远高于使用国际银行卡。Dodo Payments 支持 GCash（菲律宾）、Alipay HK 和 FPS（香港）以及 Touch ‘n Go（马来西亚），每种方式均以当地货币计费。

本页面介绍菲律宾、香港和马来西亚。有关其他亚洲市场，请参阅印度了解 UPI 和 Rupay，参阅韩国了解 Kakao Pay、Naver Pay 和 PAYCO，以及参阅 WeChat Pay 了解中国客户。

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

Wallet-First Markets

在菲律宾和马来西亚，GCash 和 Touch ‘n Go 是在线支付的默认方式，远远领先于输入银行卡信息支付。

Low Card Penetration

该地区大部分市场的银行卡持有率有限。本地电子钱包和银行支付网络能够触达仅支持银行卡的结账方式无法覆盖的客户。

Instant Settlement

FPS 在香港实现银行间实时清算，因此付款会在结账过程中确认，而不是数小时后才确认。

支持的方式

方式	国家/地区	计费货币	订阅	最低金额
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

这四种方式均仅支持一次性付款。 它们都不支持订阅或任何其他周期性收费。在订阅结账中务必包含 credit 和 debit，以便这些市场的客户仍可注册。

客户使用当地货币付款，而你收到的结算货币为 USD，与其他所有非 USD 方式相同。

方式详情

GCash (Philippines)

GCash 是菲律宾最大的电子钱包，可用于支付账单、在线购物等各种消费。客户在 GCash 应用中批准付款，然后返回你的成功页面。适用于以 菲律宾（PH） 为计费国家、以 PHP 计费的 一次性 结账。

Alipay HK (Hong Kong)

Alipay HK 是 Alipay 的香港版本，面向当地市场运营，并以港元结算。它与中国大陆的 Alipay 产品是不同的支付方式。适用于以 香港（HK） 为计费国家、以 HKD 计费的 一次性 结账。Alipay HK 仅以 HKD 结算，因此即使计费国家为香港，在 CNY 结账中也不会显示。

FPS (Hong Kong)

FPS（Faster Payment System）是香港的实时银行间转账网络，由香港金融管理局运营。客户直接从银行账户付款，转账会立即完成清算。适用于以 香港（HK） 为计费国家、以 HKD 或 CNY 计费的 一次性 结账。

Touch 'n Go (Malaysia)

Touch ‘n Go 是马来西亚占主导地位的电子钱包。客户在 Touch ‘n Go 应用中确认付款，然后返回你的成功页面。适用于以 马来西亚（MY） 为计费国家、以 MYR 计费的 一次性 结账。

配置

API 方式类型

类型	说明
`gcash`	GCash 电子钱包（菲律宾）
`ali_pay_hk`	Alipay HK 电子钱包（香港）
`fps`	FPS 实时银行转账（香港）
`touch_n_go`	Touch ‘n Go 电子钱包（马来西亚）

示例：菲律宾结账

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'
});

示例：香港结账

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'
});

示例：马来西亚结账

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'
});

要求

要使这些方式显示在结账页面中：

计费国家/地区 与支付方式的市场匹配 — GCash 使用 PH，Alipay HK 和 FPS 使用 HK，Touch ‘n Go 使用 MY
货币与支付方式匹配 — PHP、HKD（FPS 也可使用 CNY）或 MYR
付款类型 为一次性付款，而不是订阅
对于使用其他货币定价的商家：必须启用 Adaptive Currency，以便客户使用当地货币计费

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

测试

Enable test mode

使用你的 Dodo Payments 测试 API 密钥。

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 中包含支付方式类型。这些方式不提供给订阅结账。

Select the method and confirm

在结账页面选择支付方式，然后点击 Pay。二维码会在全屏叠加层中打开，结账页面会等待付款完成。

Verify the checkout behavior

确认该方式仅在匹配的国家/地区和货币下显示，并确认二维码能够正常渲染。

测试模式二维码由电子钱包提供商的测试环境生成，其行为可能与真实付款不同。

最佳实践

Lead with the local wallet

在菲律宾和马来西亚，本地电子钱包是客户首选的付款方式。除了银行卡之外列出 GCash 或 Touch ‘n Go，可以显著降低客户放弃付款的比例。

Offer both Hong Kong methods

Alipay HK 和 FPS 服务于不同的客户群体——电子钱包用户和银行转账用户。在 HKD 结账中同时提供这两种方式，以便 Dodo Payments 根据客户偏好呈现相应选项。

Keep cards on subscription checkouts

由于本页面中的每种方式都仅支持一次性付款，仅列出本地电子钱包的订阅结账页面将没有可显示的方式。对于周期性方案，务必包含 credit 和 debit。

Match currency to region

这些方式要求使用当地计费货币。如果你的目录以 USD 或 EUR 定价，请启用 Adaptive Currency，以便向客户报价并使用 PHP、HKD、CNY 或 MYR 计费。

故障排除

Method not appearing at checkout

检查：

计费国家/地区是否设置为 PH、HK 或 MY，并与支付方式匹配？
计费货币是否设置为 PHP、HKD、CNY 或 MYR，并与支付方式匹配？
这是一次性付款吗？这些方式均不会显示在订阅中。
是否已在 allowed_payment_method_types 中包含支付方式（gcash、ali_pay_hk、fps 或 touch_n_go）？
如果使用其他货币定价：是否已启用 Adaptive Currency？

解决方案： 暂时移除 allowed_payment_method_types，以查看所有符合条件的方式，然后逐步缩小范围，找出不满足的条件。

Alipay HK missing on a CNY checkout

原因： Alipay HK 仅以 HKD 结算。以 CNY 计费的香港结账会提供 FPS，但不会提供 Alipay HK。解决方案： 使用 HKD 计费以提供 Alipay HK，或在香港的 CNY 结账中包含 fps。

Wallet missing on a subscription

原因： GCash、Alipay HK、FPS 和 Touch ‘n Go 均仅支持一次性付款，永远不会用于周期性计费。解决方案： 在这些市场的订阅中使用 credit 和 debit。

Payment not confirming

原因： 这些方式会将客户重定向到电子钱包应用或银行应用。如果客户放弃操作，付款将保持未完成状态。解决方案： 监控 webhooks 以获取最终付款状态，而不要依赖返回重定向。请参阅 Webhooks 指南。

Payment Methods Overview

查看所有支持的支付方式。

Adaptive Currency

使用当地货币向客户计费，包括 PHP、HKD、CNY 和 MYR。

Checkout Guide

完整的结账实施指南。

Testing Process

测试数据和结账测试指南。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Wallet-First Markets

Low Card Penetration

Instant Settlement

支持的方式

方式详情

配置

API 方式类型

示例：菲律宾结账

示例：香港结账

示例：马来西亚结账

要求

测试

最佳实践

故障排除

相关页面

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

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

Wallet-First Markets

Low Card Penetration

Instant Settlement

​支持的方式

​方式详情

​配置

​API 方式类型

​示例：菲律宾结账

​示例：香港结账

​示例：马来西亚结账

​要求

​测试

​最佳实践

​故障排除

​相关页面

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

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

支持的方式

方式详情

配置

API 方式类型

示例：菲律宾结账

示例：香港结账

示例：马来西亚结账

要求

测试

最佳实践

故障排除

相关页面