跳转到主要内容

SDKs & Libraries

通过使用官方的 TypeScript、Python、Go、PHP、Java、Kotlin、C#、Ruby 和 React Native SDK 加速您的集成。这些库简化了 API 请求、身份验证和错误处理，让您专注于构建出色的支付体验。

​
环境 URL

了解更多关于 测试模式与实时模式 的信息。

​
API 密钥管理和身份验证

1

访问 API 密钥

在您的仪表板中导航到 开发者 → API 密钥 以管理您的密钥。
2

生成新密钥

选择 添加 API 密钥，提供描述性名称，并配置写入权限：
  • 启用写入权限（已勾选）：对所有 API 操作具有完全的读写权限
  • 启用写入权限（未勾选）：只读访问 - 只能获取数据（支付、订阅、客户、产品）。无法创建或修改资源。
对于仪表板集成、分析工具和任何只需查看数据而不进行更改的系统，请取消勾选 “启用写入权限”。
3

安全存储您的密钥

立即复制生成的密钥，并确保安全存储。
4

验证您的 API 请求

使用您的 API 密钥来验证所有请求。应用以下授权格式：
Authorization: Bearer YOUR_API_KEY
切勿在客户端代码或公共代码库中暴露您的秘密 API 密钥。

​
响应格式

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
速率限制

  • 标准: 每个业务每分钟 1000 次请求
  • 突发: 每秒最多 100 次请求
监控 X-RateLimit-Remaining 头以跟踪使用情况。

​
错误处理

要有效管理错误，请查阅 错误代码 和 交易失败 部分以获取详细指导。

错误代码

深入了解全面的错误详情及其解决方案。

交易失败

获取有关常见交易问题及其解决方案的见解。

​
Webhooks

接收有关支付事件的实时通知。请参阅我们的 Webhook 指南 以获取设置说明。

Webhook 指南

设置 Webhook 以获取实时通知和事件处理。