修正发货回调流程
This commit is contained in:
@@ -67,7 +67,6 @@ const scopeOptions = [
|
||||
{ value: 'orders:read', label: '订单读取' },
|
||||
{ value: 'orders:write', label: '订单写入' },
|
||||
{ value: 'fulfillment:read', label: '履约读取' },
|
||||
{ value: 'fulfillment:write', label: '履约写入' },
|
||||
{ value: 'wallet:read', label: '钱包读取' },
|
||||
]
|
||||
|
||||
|
||||
@@ -35,9 +35,9 @@ export default function OpenApiDocs() {
|
||||
开放接口
|
||||
</Title>
|
||||
<Paragraph type="secondary">
|
||||
面向商户系统、履约器和外部平台调用的通用开放 API。凭证在「商户中心 / API 客户端」创建,
|
||||
面向商户系统调用的开放 API。凭证在「商户中心 / API 客户端」创建,
|
||||
采用 <Text code>X-App-Key</Text> + HMAC-SHA256 签名鉴权。
|
||||
原 <Text code>/api/open/v1</Text> 保留给上游发货对接,不在本页展示。
|
||||
<Text code>/api/open/v1</Text> 仅保留给发货平台查询与回传,不在本页展示。
|
||||
</Paragraph>
|
||||
|
||||
<Tabs
|
||||
@@ -80,7 +80,7 @@ function OverviewTab() {
|
||||
<li>在「商户中心 / API 客户端」创建凭证,获得 <Text code>AppKey</Text> 与 <Text code>AppSecret</Text>。</li>
|
||||
<li>每次请求携带 <Text code>X-App-Key / X-Timestamp / X-Nonce / X-Sign</Text> 四个鉴权头。</li>
|
||||
<li>调用「商品列表」拿到可售 <Text code>sku</Text>,调用「下单」创建订单并扣款。</li>
|
||||
<li>履约器通过「发货回传」回写 processing/success/failed,状态可由「查询订单」轮询。</li>
|
||||
<li>拿到 <Text code>order_no</Text> 后进入发货链接;订单状态由发货平台回调更新,可通过「查询订单」轮询。</li>
|
||||
</ol>
|
||||
}
|
||||
/>
|
||||
@@ -234,13 +234,13 @@ function StatusTab() {
|
||||
↓
|
||||
POST /orders 下单(幂等,Idempotency-Key = client_order_no)
|
||||
↓
|
||||
(履约器)POST /orders/{order_no}/ship-notify ship_status=processing
|
||||
拿响应里的 order_no 进入发货平台链接
|
||||
↓
|
||||
按 product.sku 发货
|
||||
发货平台查询订单并执行发货
|
||||
↓
|
||||
POST /orders/{order_no}/ship-notify ship_status=success 或 failed
|
||||
发货平台通过上游回调更新 fulfillment_status
|
||||
↓
|
||||
(可选)GET /orders/{order_no} 轮询确认 fulfillment_status=succeeded`}</pre>
|
||||
GET /orders/{order_no} 轮询,或接收 order.fulfillment.updated 回调`}</pre>
|
||||
}
|
||||
/>
|
||||
</Space>
|
||||
|
||||
Reference in New Issue
Block a user