docs(pay): return_url 跳用户中心 + 用户中心订单历史页纳入 v1

新增 GET /v1/pay/orders 列表接口(历史订单);范围加用户中心订单页(读该接口、
新增导航、return_url 跳此);待确认清单收口(仅剩哪吒 pid/密钥,不挡开发)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-07-09 23:04:10 +08:00
parent 674ee504cb
commit c33ac6d258
+7 -5
View File
@@ -257,6 +257,7 @@ type CallbackResult struct { Handled bool; Event *PaidEvent; AckBody []byte } //
<pre>GET /v1/pay/methods → 200 [{id,name,icon,render_type,currency,enabled,min,max}]
POST /v1/pay/orders {sku, method} → 201 {order_no, status, session:{render_type,payload,expires_at}}
GET /v1/pay/orders/{order_no} → 200 {status, plan, expires_at, session?}
GET /v1/pay/orders?limit&cursor → 200 {orders:[{order_no,sku,plan,amount,currency,status,created_at,paid_at}], next} (历史订单,用户中心订单页用)
POST /v1/pay/orders/{order_no}/retry {method} → 201 新 session(Order 不变)
--- 平台→控制面(公开,不带 Bearer)---
POST /v1/webhooks/pay/crypto (pangolin-pay, HMAC 验签)
@@ -326,13 +327,14 @@ GET /v1/webhooks/pay/nazha (哪吒, RSA 验签, GET)</pre>
</ul>
<h2>11. 首版范围与实施阶段</h2>
<p>范围:<b>后端编排层 + crypto & 哪吒两 adapter + 四端 Flutter 统一支付页</b>一次到位。用户中心(web)支付页作为快速跟进(复用同一套 REST,小改)。实施在计划里分阶段:</p>
<p>范围:<b>后端编排层 + crypto & 哪吒两 adapter + 四端 Flutter 统一支付页 + 用户中心订单历史页</b>一次到位。实施在计划里分阶段:</p>
<ol>
<li>控制面:schema(pay_orders/pay_attempts)+ store + 开通重构 + source=pay migration。</li>
<li>Provider 抽象 + 注册表 + crypto adapter + pay-server 出站 webhook。</li>
<li>哪吒 adapter(RSA 签/验、GET 回调、查单)。</li>
<li>客户端 REST(methods/orders/retry/webhooks)+ 统一开通管线 + Query 轮询 worker。</li>
<li>客户端 REST(methods/orders/list/retry/webhooks)+ 统一开通管线 + Query 轮询 worker。</li>
<li>Flutter 支付页(方法选择器 + render_type 分发 + 轮询)+ 接上购买入口。</li>
<li>用户中心订单历史页(读 <code>GET /v1/pay/orders</code>,新增导航项;<code>return_url</code> 跳此)。</li>
<li>端到端联调(两轨小额)。</li>
</ol>
@@ -342,10 +344,10 @@ GET /v1/webhooks/pay/nazha (哪吒, RSA 验签, GET)</pre>
<tbody>
<tr><td>SKU 三档 + USDT 价($3.99/$9.99/$29.99)</td><td><span class="tag ok">已定</span></td></tr>
<tr><td>CNY 价(¥29.99/¥68.88/¥199.99)</td><td><span class="tag ok">已定</span></td></tr>
<tr><td>哪吒商户注册(pid + RSA 密钥对)</td><td><span class="tag warn">你去 Telegram 开户后给我</span></td></tr>
<tr><td>return_url 成功落地页(用户中心 or 官网一页)</td><td><span class="tag warn"></span></td></tr>
<tr><td>哪吒商户注册(pid + RSA 密钥对)</td><td><span class="tag warn">你去 Telegram 开户后给我(不挡开发)</span></td></tr>
<tr><td>return_url → 跳用户中心订单页</td><td><span class="tag ok"></span></td></tr>
<tr><td>Order + PaymentAttempt 两层模型</td><td><span class="tag info">本设计采用</span></td></tr>
<tr><td>用户中心 web 支付页是否本轮做</td><td><span class="tag info">提案:快速跟进,非 v1</span></td></tr>
<tr><td>用户中心订单历史页</td><td><span class="tag ok">已定:本轮做</span></td></tr>
</tbody>
</table>