跳转到主要内容
Dodo Payments 支持多种支付方式，以帮助您为全球客户提供服务。所有列出的支付方式在您的商户账户验证通过并启用实时模式后会自动可用。
自动激活： 您无需进行额外配置。所有支付方式均由 Dodo Payments 预配置和管理。您可以选择使用下面描述的 API 配置来限制在结账时显示哪些方式。

​
支持的支付方式

下表提供了所有可用支付方式、其区域可用性和主要限制的快速参考：
支付方式支持国家支持货币支持订阅
信用卡全球所有货币是
借记卡全球所有货币是
Apple Pay全球（不包括印度）所有货币是
Google Pay全球（不包括印度）所有货币是
Amazon Pay全球（不包括印度）美元否
Cash App Pay美国美元否
Afterpay (BNPL)美国，英国美元，英镑否
Klarna (BNPL)美国，欧洲*美元，欧元，英镑，丹麦克朗，挪威克朗，瑞典克朗，捷克克朗，罗马尼亚列伊，波兰兹罗提，瑞士法郎否
PayPal全球欧元，英镑否
UPI印度印度卢比是*
Rupay (信用/借记)印度印度卢比是*
Bancontact比利时欧元否
EPS奥地利欧元否
iDEAL荷兰欧元否
Multibanco葡萄牙欧元否
每笔交易必须满足 每种货币的最低金额要求。对于美元，最低金额为 0.50 美元。其他货币的最低金额因地区而异。 查看支持的货币和最低金额
Klarna 和 Afterpay 在结账时要求最低交易金额为 50.01 美元（或等值的支持货币）。低于此阈值的交易将不符合这些 BNPL 支付选项的资格。有关 Klarna 支持的国家的详细信息，请参阅下面的 BNPL 部分。
印度支付方式： UPI 和 Rupay 订阅支持符合 RBI 的授权。有关授权限制和处理延迟的重要细节，请参阅 符合 RBI 的授权的订阅 部分。

​
支付方式详细信息

Dodo Payments 全球接受所有主要的信用卡和借记卡网络。您可以接受：
  • Visa – 可靠、广泛接受的全球网络
  • Mastercard – 强大、安全的全球网络
  • American Express – 高端福利和强大的客户服务
  • Discover – 竞争力的奖励，强大的美国市场
  • JCB – 领先的亚洲卡网络，正在扩展
  • UnionPay – 在中国和亚洲占主导地位，全球接受度不断提高
  • Interac – 加拿大的安全借记支付网络
  • Cartes Bancaires – 在法国广泛使用
  • Diners Club – 高端国际卡，享有独特福利
  • 韩国本地卡 – 支持韩国国内卡网络
为客户提供快速安全的结账体验，使用数字钱包：
  • Apple Pay – 在 iOS、macOS 和 watchOS 上轻松支付
  • Google Pay – 在 Android、网页和实体店进行安全支付
  • PayPal – 全球支付，支持欧元和英镑（不适用于订阅）
  • Cash App Pay – 美国客户的移动支付（不适用于订阅）
  • Amazon Pay – 使用亚马逊凭证进行简单结账（不适用于订阅）
通过提供灵活的分期付款选项来提高转化率：
  • Klarna – 通过 Klarna 的选项启用灵活支付：分 4 期付款、30 天内付款或为您的购买融资。Klarna 在美国和 19 个欧洲国家可用，包括奥地利、比利时、捷克共和国、丹麦、芬兰、法国、德国、希腊、爱尔兰、意大利、荷兰、挪威、波兰、葡萄牙、罗马尼亚、西班牙、瑞典、瑞士和英国。支持的货币包括美元、欧元、英镑、丹麦克朗、挪威克朗、瑞典克朗、捷克克朗、罗马尼亚列伊、波兰兹罗提和瑞士法郎。
  • Afterpay – 允许客户将购买分成四个无息付款。Afterpay 在美国和英国可用，支持美元和英镑的支付。
接受领先的印度支付选项：
  • UPI – 客户扫描二维码或使用应用程序（Google Pay、PhonePe、Paytm、CRED）进行即时、无接触的银行转账
  • Rupay 卡 – 通过印度的国内卡网络进行安全的信用和借记支付
提供本地化的欧洲选项以提高转化率：
  • iDEAL（荷兰） – 荷兰即时在线银行支付
  • Bancontact（比利时） – 比利时受信任的借记卡方式
  • Multibanco（葡萄牙） – 葡萄牙的银行转账和 ATM 支付支付方式
  • EPS（奥地利） – 奥地利的直接在线银行支付

​
配置支付方式

虽然所有支付方式会根据客户的位置和货币自动可用，但您可以选择使用 allowed_payment_method_types 参数限制在结账时显示哪些支付选项。

​
何时配置支付方式

您可能希望配置允许的支付方式以：
  • 根据您的业务需求控制客户看到的支付选项
  • 限制特定产品类型或交易流程的支付方式
  • 在不同的支付体验中保持一致性
  • 为目标受众优化结账体验

​
实施

1

将参数添加到 API 请求

在您的支付或订阅创建请求中包含 allowed_payment_method_types 字段：
{
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay"
  ]
}
2

测试配置

验证结账时仅显示指定的支付方式。
使用不同的客户位置和货币测试支付方式的可用性，以确保配置按预期工作。

​
API 端点

此配置由以下端点支持：

创建结账会话

创建具有允许支付方式的结账会话。

创建支付

使用允许的方法进行一次性支付。

创建订阅

使用循环方法进行订阅支付。

​
实施示例

{
  "amount": 1000,
  "currency": "usd",
  "allowed_payment_method_types": [
    "credit",
    "debit",
    "apple_pay",
    "google_pay"
  ]
}

​
最佳实践

如果未指定 allowed_payment_method_types，所有符合条件的支付方式将根据客户的位置、货币和交易类型可用。仅在需要限制支付方式时使用此参数。
在选择支付方式时考虑您的目标市场。包括特定区域的选项（如印度的 UPI 或荷兰的 iDEAL）可以显著提高这些市场的转化率。
跟踪客户最常使用的支付方式，并根据实际使用模式和转化数据调整您的允许方式。

​
重要考虑事项

支付方式的可用性取决于多个因素：
  • 客户位置：某些支付方式是区域特定的
  • 商户设置：您的账户配置和能力
  • 货币：支持的支付方式因货币而异
  • 交易类型：某些方法不支持订阅或有最低金额要求
将支付方式添加到 allowed_payment_method_types 并不保证它会出现 - 它还必须根据这些因素符合资格。

​
故障排除

可能原因：
  • 支付方式未包含在 allowed_payment_method_types 中
  • 支付方式不支持客户的位置
  • 支付方式不支持交易货币
  • 对于订阅：支付方式不支持循环支付
  • 交易金额低于最低阈值（例如，BNPL 方法）
解决方案： 验证所有资格要求是否满足，并检查您的 API 请求配置。
可能原因：
  • allowed_payment_method_types 参数未正确传递
  • 您的商户仪表板中可能存在冲突的配置
解决方案： 检查您的 API 请求有效负载，确保参数正确格式化为字符串数组。
可能原因：
  • 客户的位置与支付方式的支持区域不匹配
  • 货币不被区域支付方式支持
  • 您的商户账户可能未启用该特定支付方式
解决方案： 验证区域和货币的兼容性，如果您认为该方法应该可用，请联系支持团队。
升级/降级后订阅收费失败：
  • 新的收费金额可能超过现有授权限制（₹15,000 阈值）
  • 客户可能需要更新其支付方式以建立新的授权
解决方案： 提示客户更新其支付方式或调整订阅金额以保持在授权限制内。收费发起后订阅挂起：
  • 客户可能在 48 小时处理窗口内取消了授权
  • 客户可能未能授权高价值收费（≥₹15,000）
解决方案： 监控授权取消和支付失败的 webhook 事件。实施重试逻辑或提示客户重新建立其支付方式。支付扣款延迟：
  • 正常行为：印度卡和 UPI 订阅在收费发起和实际扣款之间有 48 小时的延迟
  • 根据银行 API，此延迟可能延长至 2-3 小时
解决方案： 这是预期的行为。在通过 webhook 收到支付确认之前，请勿激活福利或积分。
何时更新支付方式：
  • 客户的卡过期或被替换
  • 客户希望使用不同的支付方式
  • 由于支付失败，订阅处于 on_hold 状态
  • 由于任何原因需要更改支付方式
对于活跃的订阅： 更新活跃订阅的支付方式仅会更新未来续订的支付方式。不会立即产生收费。对于挂起的订阅： 当订阅处于 on_hold 状态（由于续订失败或计划变更收费失败），更新支付方式将：
  • 自动为剩余欠款创建收费
  • 为收费生成发票
  • 使用新的支付方式处理支付
  • 在成功支付后将订阅重新激活为 active 状态
// Update payment method for active subscription
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

// For on_hold subscription - automatically creates charge
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}
Webhook 事件：
  • 对于 on_hold 订阅：您将收到 payment.succeeded，然后在成功更新支付方式后收到 subscription.active
  • 监控这些事件以跟踪订阅重新激活状态

更新支付方式 API 参考

查看更新支付方式的完整 API 文档。

订阅状态

了解有关订阅状态的更多信息，包括活跃和挂起状态。

​
扩展支付选项

我们不断向 Dodo Payments 添加新的支付方式。此页面将在更多选项可用时更新。如果您需要此处未列出的特定支付方式，请通过 [email protected] 联系我们，我们将考虑将其添加到我们的路线图中。