生产 API 请求流程

具有明确所有权范围和交易可审计性的实时操作的推荐请求顺序。

  1. 验证并获取用户 JWT 或应用 API 密钥。
  2. 通过创建或更新产品 /v1/products (POST, PUT, PATCH);看 产品 API 增删改查多语言示例.
  3. 使用您的产品 ID 从 Pay 开始结账。
  4. 接收并验证回调/webhook 签名(payment.confirmed + 镜像验证)。
  5. 查询交易结果 /v1/transaction/status 或者 /v1/transactions - 看 交易详情.

必需的标头

Authorization: Bearer <token>
Content-Type: application/json

错误处理基线

  • 使用指数退避重试瞬时故障 (5xx)。
  • 对待 401/403 作为授权/许可问题。
  • 对待 409 作为业务冲突(例如产品删除阻止程序)。
  • 记录事务 ID、Webhook 事件 ID 和请求 ID 以进行跟踪。