支付回跳确认

用途

在 Stripe 或 PayPal 收银台返回个人中心后，核验真实支付状态并刷新积分与订单，补偿本地 Webhook 延迟或未送达的情况。

使用前准备

管理员需启用对应支付渠道；平台订单必须已成功创建，并保留创建订单时使用的不可变渠道配置版本。

操作步骤

配图占位：支付回跳后的积分页面状态提示和订单记录。

1. 收银台把用户带回「个人中心 → 积分与充值」，并附带平台订单号。
2. 页面调用 POST /api/payments/orders/{orderId}/confirm；服务端校验订单归属后向支付渠道查询状态。
3. PayPal 回跳会先调用 POST /api/payments/orders/{orderId}/capture，再执行相同的确认流程。

结果与状态

只有渠道确认订单已付款时，系统才会把订单更新为 PAID 并发放积分。渠道仍在处理时页面显示“确认中”；取消或确认失败会显示对应提示。处理后会移除一次性回跳参数，刷新页面不会重复显示旧结果。

权限和边界

确认接口只允许登录用户查询自己的订单，且不会相信浏览器传入的成功状态。回跳确认用于补偿 Webhook 延迟，不能替代生产环境 Webhook。

常见问题

为什么回到页面后仍显示确认中？

支付渠道尚未返回付款终态。稍后刷新订单状态；后台对账任务也会继续处理该订单。

相关文档

• 支付、订单与退款