积分
校验结账会话
校验已完成的结账会话并确认积分已入账。
GET
概述
支付成功后,可调用此接口确认付款已处理且积分已入账。适用于 Webhook 未及时触达等场景的手动校验。积分通常由 Stripe Webhook 自动入账。本接口用于边界情况或客户端侧的额外确认。
**第三方集成:**请改用
GET /credits/verify-session/{sessionId}/api 并以 API Key 鉴权。认证
JWT 访问令牌(会话鉴权)。格式:
Bearer YOUR_ACCESS_TOKEN路径参数
/credits/checkout 返回的 Stripe Checkout 会话 ID。响应字段
会话校验是否成功。
本次购买对应的积分数。
已校验的会话 ID。
错误响应
400
错误请求——支付未完成或会话元数据无效。
401
未授权——令牌无效或缺失。
403
禁止访问——会话不属于当前认证用户。
幂等性
本接口具有幂等性。若积分已通过 Webhook 入账,不会重复增加;仍会返回成功及对应积分数量。典型流程
- 用户在 Stripe 完成结账
- Stripe 将用户重定向到你的
successUrl - 调用本接口校验并确认积分
- 向用户展示确认信息
- 在前端刷新积分余额展示