docs(pay): 统一支付编排层设计(provider 无关,加渠道不改客户端)

Order+PaymentAttempt+Provider adapter(Create/HandleCallback/Query)三动作,
客户端只认 render_type 联合体(redirect/display_details/…)。首批 crypto
(包裹 pangolin-pay,display_details)+ 哪吒(支付宝跳转 redirect,RSA/GET 回调,
灰产四方可随时换持牌)。统一开通管线复用 codes,source=pay。四端 Flutter 支付页。
登记 docs/index.html。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-07-09 22:05:20 +08:00
parent bced7b35e0
commit b327798511
2 changed files with 278 additions and 0 deletions
+5
View File
@@ -44,6 +44,11 @@
</div>
<h2>设计方案 / Specs</h2>
<a class="doc" href="pay-orchestration-design.html">
<div class="t">统一支付编排层 · provider 无关架构(加渠道不改客户端)<span class="tag html">HTML</span></div>
<div class="d">控制面新增支付编排层:<b>Order 业务订单 + PaymentAttempt 支付尝试 + Provider 适配器(Create/HandleCallback/Query</b>,客户端只认服务端下发的少数 <b>render_type</b>redirect/display_details/…)联合体,不认具体平台 → 同形态新网关零改客户端。首批接 crypto(USDT-TRC20,包裹已部署 pangolin-paydisplay_details) + 哪吒聚合支付(支付宝跳转,redirect,RSA 签/GET 回调,<b>灰产四方·可随时换持牌</b>)。统一开通管线(验签→定位→幂等→金额核对→复用 codes 开通,source=pay+ Query 轮询兜底。四端 Flutter 统一支付页。含 SKU 目录/双币定价/两表 schema/边界与合规。</div>
<div class="path">docs/pay-orchestration-design.html</div>
</a>
<a class="doc" href="payment-reseller-fulfillment-design.html">
<div class="t">支付落地方案 · 发卡/Reseller 收款 + 激活码自动发货 <span class="tag html">HTML</span></div>
<div class="d">把「收钱」与品牌 VPN 主体解耦:收款外包给发卡平台/Reseller(他们承担支付宝/微信跑分、冻卡、跑路风险),你只交付「激活码」;客户端/用户中心只认码,codes 模块核销即生效。含完整流程图(钱流/码流/结算)、两种对接模型(A 预充卡密库存 / B API 实时签发 POST /v1/codes/issue)、三阶段落地节奏、对账与风险边界(主体永不碰跑分/中国支付)。灰产“付完秒发货”体验的合规化替身。</div>