扫码支付

更新： 2026-09-18 状态： 已发布（通道可用性按商户签约配置确定）

接入流程

1. 商户服务端调用 POST /open/v1/checkout-sessions，scene 传 QRCODE。
2. 成功响应的 action.type 为 QRCODE_URL，二维码原始内容位于 action.payload.qrcodeUrl。
3. 前端将原始内容编码为二维码，并显示 action.expiresAt 对应的倒计时。
4. 商户服务端查询 GET /open/v1/checkout-sessions/{sessionId}，或接收 Webhook；前端不直接调用需要 HMAC 凭据的 /open/v1 接口。
5. 如使用 SmartPay 托管页，访问 /checkout/{sessionId}；其公开脱敏轮询路径为 /checkout/{sessionId}/status。

二维码生命周期

• 二维码是短期会话资源，过期后重新创建支付会话。
• “已扫码”不等于“已支付”，只有 SUCCEEDED 是支付成功。
• 不要将二维码原始内容写入日志或长期存储。