跳转到主要内容

React Native SDK 集成

Dodo Payments React Native SDK 使您能够在本机 Android 和 iOS 应用中构建安全的支付体验。我们的 SDK 提供可自定义的 UI 组件和收集支付详细信息的屏幕。
  • 📦 从 NPM 安装我们的 SDK
  • 📚 查看我们的 演示仓库 以获取完整的实现示例
  • 🎥 观看我们的 演示视频 以查看 Dodo Payments SDK 的实际应用

特性

Simplified Security

在保持符合 PCI 要求的同时安全地收集敏感支付数据

Multiple Payment Methods

接受各种支付方式以拓展全球覆盖范围

Native UI

为 Android 和 iOS 提供原生界面与元素
目前,React Native SDK 还不支持 Apple Pay、Google Pay、Cash App 和 UPI。我们正在积极努力,在未来版本中添加对这些支付方式的支持。

安装

1

Install the SDK

使用您首选的包管理器安装 Dodo Payments SDK:
2

Platform-specific setup

在 iOS 目录中运行 pod install:

客户端设置

1

Get Publishable Key

从 Dodo Payments 控制面板获取您的可发布密钥。(测试模式和直播模式各自独立) https://app.dodopayments.com/developer/others
2

Setup Payment Provider

使用 DodoPaymentProvider 包裹您的应用:
App.tsx
您需要从 Dodo Payments 控制面板生成 API 密钥。有关详细说明,请参阅我们的API 密钥生成指南
3

Create payment utility function

创建一个实用函数,从您的后端 API 获取支付参数:
utils/fetchPaymentParams.ts
该函数假定您已有一个后端 API 端点用于创建支付意图并返回客户端密钥。请确保您的后端已正确配置以处理支付创建。有关后端设置示例,请参见我们的API 集成教程
4

Implement the payment screen

使用 useCheckout 钩子创建您的支付界面。以下是完整实现:
PaymentScreen.tsx
有关样式、错误处理和自定义选项的完整示例,请查看我们的演示仓库:

配置选项

会话参数

clientSecret
string
必填
从一次性支付或订阅 API 获取的支付意图客户端密钥。
mode
string
必填
支付会话的模式(测试或直播)。
configuration.appearance
object
支付界面外观的自定义选项
configuration.appearance.themes
string
主题模式:'light''dark'

外观自定义

您可以通过在调用 initPaymentSession() 时修改 appearance 参数中的颜色、字体等设置,使 React Native Unified Checkout 与您的应用设计更加一致。

颜色自定义

每个颜色分类决定了 UI 中一个或多个组件的颜色。例如,primary 定义了支付按钮的颜色。 示例配置,支持浅色和深色模式:

形状自定义

您可以自定义支付界面中使用的边框半径、边框宽度和阴影:

组件特定自定义

您可以自定义特定的 UI 组件,如主按钮(支付按钮)。这些设置优先于全局外观设置:
要应用这些自定义设置,请将它们包含在您的支付会话配置中:

错误处理

在您的结账函数中处理不同的支付状态:
  • 网络连接问题:确保网络连接稳定
  • 客户端密钥无效:验证后端是否生成了有效的支付意图
  • 缺少对等依赖:安装所有必需依赖项
  • 平台特定配置:完成 iOS 和 Android 的配置步骤
  • API 错误:查阅我们的错误代码参考以获取详细的错误处理信息
  • 在开发中启用调试日志
  • 检查到后端的网络请求
  • 验证 API 密钥配置正确
  • 在 iOS 和 Android 平台上测试
  • 查看我们的技术常见问题以获取常见问题的解答
  • 适当地使用测试模式与实时模式

测试支付方式

在开发过程中使用测试卡号,以便在不处理真实支付的情况下验证集成。了解我们的测试流程和可用的测试环境。
最后修改于 2026年5月28日