React Native SDK 集成
Dodo Payments React Native SDK 使您能够在本机 Android 和 iOS 应用中构建安全的支付体验。我们的 SDK 提供可自定义的 UI 组件和收集支付详细信息的屏幕。特性
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:
- npm
- yarn
2
Platform-specific setup
- iOS
- Android
在 iOS 目录中运行 pod install:
客户端设置
1
Get Publishable Key
从 Dodo Payments 控制面板获取您的可发布密钥。(测试模式和直播模式各自独立)
https://app.dodopayments.com/developer/others
2
Setup Payment Provider
3
Create payment utility function
创建一个实用函数,从您的后端 API 获取支付参数:
utils/fetchPaymentParams.ts
该函数假定您已有一个后端 API 端点用于创建支付意图并返回客户端密钥。请确保您的后端已正确配置以处理支付创建。有关后端设置示例,请参见我们的API 集成教程。
4
Implement the payment screen
配置选项
会话参数
从一次性支付或订阅 API 获取的支付意图客户端密钥。
支付会话的模式(测试或直播)。
支付界面外观的自定义选项
主题模式:
'light' 或 'dark'外观自定义
您可以通过在调用initPaymentSession() 时修改 appearance 参数中的颜色、字体等设置,使 React Native Unified Checkout 与您的应用设计更加一致。
颜色自定义
每个颜色分类决定了 UI 中一个或多个组件的颜色。例如,primary 定义了支付按钮的颜色。
示例配置,支持浅色和深色模式:
形状自定义
您可以自定义支付界面中使用的边框半径、边框宽度和阴影:组件特定自定义
您可以自定义特定的 UI 组件,如主按钮(支付按钮)。这些设置优先于全局外观设置:错误处理
在您的结账函数中处理不同的支付状态:Common Error Scenarios
Common Error Scenarios
- 网络连接问题:确保网络连接稳定
- 客户端密钥无效:验证后端是否生成了有效的支付意图
- 缺少对等依赖:安装所有必需依赖项
- 平台特定配置:完成 iOS 和 Android 的配置步骤
- API 错误:查阅我们的错误代码参考以获取详细的错误处理信息