亚太地区支付方式

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

本页面介绍菲律宾、香港和马来西亚。有关其他亚洲市场，请参阅印度了解 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，点击 Pay，然后使用 GCash 应用扫描 QR 码以批准付款。适用于以 菲律宾（PH） 为结算国家/地区、以 PHP 结算的 一次性 结账。

Alipay HK (Hong Kong)

Alipay HK 是 Alipay 的香港版本，服务于本地市场，并以港币结算。它与中国大陆的 Alipay 产品是不同的付款方式。结账时显示为 AlipayHK。适用于以 香港（HK） 为结算国家/地区、以 HKD 结算的 一次性 结账。Alipay HK 仅以 HKD 结算，因此不会出现在 CNY 结账中，即使结算国家/地区为香港也是如此。

FPS (Hong Kong)

FPS（Faster Payment System）是由香港金融管理局推出的香港实时支付系统。它连接银行和电子钱包，全天候运行，并支持港币和人民币。客户使用银行或电子钱包应用扫描 QR 码，资金几乎可以立即到账。适用于以 香港（HK） 为结算国家/地区、以 HKD 或 CNY 结算的 一次性 结账。

Touch 'n Go (Malaysia)

Touch ‘n Go 是马来西亚最大的电子钱包。客户使用 Touch ‘n Go 应用扫描 QR 码，然后在应用中确认付款。适用于以 马来西亚（MY） 为结算国家/地区、以 MYR 结算的 一次性 结账。

配置

API 方式类型

在 allowed_payment_method_types 中传递以下值：

类型	描述
`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。如果未启用，billing_currency 会被忽略，结账流程无法以 PHP、HKD、CNY 或 MYR 结算。

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

测试

Enable test mode

关闭控制面板侧边栏中的 Live Mode 开关，并使用在测试模式下创建的 API keys。

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。QR 码会在全屏叠加层中打开，并显示 10 分钟倒计时；叠加层打开期间，结账流程会检查付款状态。

Verify the checkout behavior

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

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

最佳实践

Lead with the local wallet

在菲律宾和马来西亚，许多客户希望使用本地钱包付款。针对这些市场，在结账流程中将 GCash 或 Touch ‘n Go 与银行卡并列展示。

Offer both Hong Kong methods

Alipay HK 和 FPS 服务于不同类型的客户：钱包用户和银行转账用户。在 HKD 结账中同时加入这两种方式，让每位客户都能看到自己偏好的方式。

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，并与方式匹配？
这是否为一次性付款？这些方式均不会出现在订阅中。
是否已将方式（gcash、ali_pay_hk、fps 或 touch_n_go）加入 allowed_payment_method_types？
是否已启用 Adaptive Currency？
金额是否达到 Supported Methods 中规定的货币最低金额？

解决方案： 暂时移除 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

原因： 客户必须扫描 QR 码，并在钱包或银行应用中批准付款。如果客户在批准前关闭应用，付款将保持未完成状态。解决方案： 使用 webhooks 获取最终付款状态，而不是依赖返回重定向。请参阅 Webhooks guide。

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 方式类型

示例：菲律宾结账

示例：香港结账

示例：马来西亚结账

要求

测试

最佳实践

故障排除

相关页面