docs: pay 对接指南升 v2 契约 + 授权管理屏文档同步 + db-schema 四新列

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-07-11 00:44:03 +08:00
parent 22e07613a1
commit 3b5d84a7e3
9 changed files with 195 additions and 80 deletions
+6 -2
View File
@@ -214,14 +214,18 @@
<div class="keys"><span class="tag pk">PRIMARY</span> <span class="mono kd">(`id`)</span><br><span class="tag uk">UNIQUE uk_code</span> <span class="mono kd">(`code`)</span><br><span class="tag ix">INDEX idx_status</span> <span class="mono kd">(`status`)</span><br><span class="tag ix">INDEX idx_redeemed_shop</span> <span class="mono kd">(`redeemed_shop_id`)</span></div>
</div><div class="card" id="license_purchases">
<h3><code class="tname">license_purchases</code> <span class="tcomment">在线购买/续费记录</span></h3>
<div class="callout ok"><b>pay 收款中枢:</b>契约见 <code>~/code/pay-contract</code>v1.0.0)。<code>out_trade_no</code> = pay 订单号,兼作对账键与幂等键(同一单只续期一次);<code>amount</code> 为 pay 下单响应回传的权威金额,webhook 回调时逐分核对</div>
<div class="callout ok"><b>pay 收款中枢:</b>契约见 <a href="pay支付对接开发指南.html">pay 支付对接开发指南</a>v2.02026-07-11 起 jiu↔pay 走 <code>/api/v2/orders</code>)。<code>out_trade_no</code> = pay 订单号,兼作对账键与幂等键(同一单只续期一次);<code>amount_minor</code>(v2 口径,int64 分)为查单/webhook 回传的权威金额,webhook 回调时逐分核对;旧 <code>amount</code> 列(v1 元字符串)保留只读兼容,观察一版后 DROP</div>
<table>
<thead><tr><th style="width:23%">列名</th><th style="width:20%">类型</th><th style="width:7%">可空</th><th style="width:16%">默认</th><th>说明</th></tr></thead>
<tbody><tr><td class="mono"><b>id</b> <span class="tag pk">PK</span></td><td class="mono ty">BIGINT UNSIGNED</td><td class="ctr"></td><td class="mono df">AUTO_INC</td><td></td></tr>
<tr><td class="mono">shop_id <span class="tag tnt">租户</span></td><td class="mono ty">BIGINT UNSIGNED</td><td class="ctr"></td><td class="mono df"></td><td></td></tr>
<tr><td class="mono">user_id</td><td class="mono ty">BIGINT UNSIGNED</td><td class="ctr"></td><td class="mono df"></td><td>下单管理员</td></tr>
<tr><td class="mono">product_biz_code</td><td class="mono ty">VARCHAR(64)</td><td class="ctr"></td><td class="mono df"></td><td>套餐稳定码:monthly_standard / annual_standard / monthly_pro / annual_pro</td></tr>
<tr><td class="mono">amount</td><td class="mono ty">VARCHAR(16)</td><td class="ctr"></td><td class="mono df">NULL</td><td>pay 下单回传金额,如 2999.00</td></tr>
<tr><td class="mono">amount_minor</td><td class="mono ty">BIGINT</td><td class="ctr"></td><td class="mono df">0</td><td>v2 口径:最小单位金额(CNY=分),如 299900=¥2999.00;下单 best-effort 查单回填,webhook 结算前核对</td></tr>
<tr><td class="mono">currency</td><td class="mono ty">VARCHAR(8)</td><td class="ctr"></td><td class="mono df">''</td><td>v2 口径:币种码,如 CNY</td></tr>
<tr><td class="mono">pay_url</td><td class="mono ty">VARCHAR(512)</td><td class="ctr"></td><td class="mono df">NULL</td><td>v2 下单 session payload.urlrender_type=redirect 时),订单管理「继续支付」复用</td></tr>
<tr><td class="mono">renewed_to</td><td class="mono ty">DATETIME</td><td class="ctr"></td><td class="mono df">NULL</td><td>settle 续期成功后的授权到期日,订单流水「授权续期至」展示</td></tr>
<tr><td class="mono">amount</td><td class="mono ty">VARCHAR(16)</td><td class="ctr"></td><td class="mono df">NULL</td><td><b>Deprecated</b>:v1 元字符串(如 2999.00),只读兼容输出,观察一版后 DROP</td></tr>
<tr><td class="mono">out_trade_no</td><td class="mono ty">VARCHAR(64)</td><td class="ctr"></td><td class="mono df">NULL</td><td>pay 订单号(对账+幂等键)</td></tr>
<tr><td class="mono">status</td><td class="mono ty">ENUM('pending','paid','failed')</td><td class="ctr"></td><td class="mono df">pending</td><td></td></tr>
<tr><td class="mono">trade_no</td><td class="mono ty">VARCHAR(64)</td><td class="ctr"></td><td class="mono df">NULL</td><td>渠道交易号(支付宝/微信)</td></tr>