From c33ac6d2585360f5d8ab65df361ca117b8b6bd6e Mon Sep 17 00:00:00 2001 From: wangjia <809946525@qq.com> Date: Thu, 9 Jul 2026 23:04:10 +0800 Subject: [PATCH] =?UTF-8?q?docs(pay):=20return=5Furl=20=E8=B7=B3=E7=94=A8?= =?UTF-8?q?=E6=88=B7=E4=B8=AD=E5=BF=83=20+=20=E7=94=A8=E6=88=B7=E4=B8=AD?= =?UTF-8?q?=E5=BF=83=E8=AE=A2=E5=8D=95=E5=8E=86=E5=8F=B2=E9=A1=B5=E7=BA=B3?= =?UTF-8?q?=E5=85=A5=20v1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 GET /v1/pay/orders 列表接口(历史订单);范围加用户中心订单页(读该接口、 新增导航、return_url 跳此);待确认清单收口(仅剩哪吒 pid/密钥,不挡开发)。 Co-Authored-By: Claude Opus 4.8 --- docs/pay-orchestration-design.html | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/pay-orchestration-design.html b/docs/pay-orchestration-design.html index 916e53d..6ac3535 100644 --- a/docs/pay-orchestration-design.html +++ b/docs/pay-orchestration-design.html @@ -257,6 +257,7 @@ type CallbackResult struct { Handled bool; Event *PaidEvent; AckBody []byte } // 
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)

11. 首版范围与实施阶段

-

范围:后端编排层 + crypto & 哪吒两 adapter + 四端 Flutter 统一支付页一次到位。用户中心(web)支付页作为快速跟进(复用同一套 REST,小改)。实施在计划里分阶段:

+

范围:后端编排层 + crypto & 哪吒两 adapter + 四端 Flutter 统一支付页 + 用户中心订单历史页一次到位。实施在计划里分阶段:

  1. 控制面:schema(pay_orders/pay_attempts)+ store + 开通重构 + source=pay migration。
  2. Provider 抽象 + 注册表 + crypto adapter + pay-server 出站 webhook。
  3. 哪吒 adapter(RSA 签/验、GET 回调、查单)。
    4. -
  4. 客户端 REST(methods/orders/retry/webhooks)+ 统一开通管线 + Query 轮询 worker。
    5. +
  5. 客户端 REST(methods/orders/list/retry/webhooks)+ 统一开通管线 + Query 轮询 worker。
  6. Flutter 支付页(方法选择器 + render_type 分发 + 轮询)+ 接上购买入口。
    7. +
  7. 用户中心订单历史页(读 GET /v1/pay/orders,新增导航项;return_url 跳此)。
  8. 端到端联调(两轨小额)。
@@ -342,10 +344,10 @@ GET /v1/webhooks/pay/nazha (哪吒, RSA 验签, GET) SKU 三档 + USDT 价($3.99/$9.99/$29.99)已定 CNY 价(¥29.99/¥68.88/¥199.99)已定 -哪吒商户注册(pid + RSA 密钥对)你去 Telegram 开户后给我 -return_url 成功落地页(用户中心 or 官网一页)待定 +哪吒商户注册(pid + RSA 密钥对)你去 Telegram 开户后给我(不挡开发) +return_url → 跳用户中心订单页已定 Order + PaymentAttempt 两层模型本设计采用 -用户中心 web 支付页是否本轮做提案:快速跟进,非 v1 +用户中心订单历史页已定:本轮做