SDKs & Libraries
适用于 TypeScript、Python、Go、PHP、Java、Kotlin、C#、Ruby 和 Rust 的官方后端 SDK。这些库简化了 API 请求、身份验证和错误处理，让您可以专注于构建出色的支付体验。
Mobile Checkout SDKs
正在构建原生应用？在 Android、iOS、React Native 和 Flutter 上打开 Dodo 的托管式结账，并通过一次调用获取类型化结果。这些 SDK 不包含 API 密钥。
环境 URL
- Test Mode：
https://test.dodopayments.com - Live Mode：
https://live.dodopayments.com
详细了解 Test Mode vs Live Mode。
API 密钥管理和身份验证
1
Access API Keys
在控制面板中依次进入 Developer → API Keys 以管理您的密钥。
2
Generate a New Key
选择 Add API Key，提供描述性名称，并配置写入权限：
- Enable write access（已选中）：对所有 API 操作拥有完整的读取和写入权限
- Enable write access（未选中）：只读访问权限——只能获取数据（支付、订阅、客户、产品）。无法创建或修改资源。
3
Store Your Key Securely
请立即复制生成的密钥，并确保将其安全存储。
4
Authenticate Your API Requests
使用 API 密钥对所有请求进行身份验证。应用以下授权格式：
响应格式
速率限制
我们的 API 使用带有突发保护的双窗口速率限制系统。限制取决于您的身份验证方式和业务层级。默认限制（Tier 0）
业务层级
对于 API 需求量较高的企业，我们提供更高的速率限制：未经身份验证的请求
没有有效身份验证标头的请求将按 IP 地址进行速率限制：速率限制标头
通过以下响应标头监控您的使用情况：X-RateLimit-Limit- 允许的最大请求数X-RateLimit-Remaining- 当前窗口中的剩余请求数X-RateLimit-Reset- 速率限制重置时间
当您超出速率限制时，API 会返回
429 Too Many Requests 响应。在重试逻辑中实现指数退避。错误处理
如需有效管理错误，请参阅 错误代码 和 交易失败 部分，以获取详细指导。Error Codes
深入了解详细的错误信息及其解决方案。
Transaction Failures
了解常见交易问题及其解决方案。
Webhooks
接收有关支付事件的实时通知。有关设置说明，请参阅我们的 Webhook 指南。Webhook Guide
设置 Webhooks，以接收实时通知并处理事件。
相关开发者指南
浏览我们的完整指南，了解如何使用 API 实现关键功能：One-time Payments Integration
了解如何将一次性支付、结账会话和支付链接集成到您的应用中
Subscription Integration
实现订阅、管理方案以及处理订阅生命周期事件的完整指南
Usage-Based Billing
为按量计费和基于用量的定价模型设置计量器和用量事件
Webhooks
接收实时通知，并通过 Webhook 事件自动执行工作流
Checkout Sessions
创建安全的托管式结账体验，并进行全面自定义及使用高级功能