增加发货平台 2

2026-07-07 08:51:23 +08:00
parent fb0ec5085f
commit c101b5f359
10 changed files with 640 additions and 1 deletions
@@ -0,0 +1,85 @@
+查询订单
+按平台内部单号或您的业务单号查询订单详情，响应结构与「创建订单」的 data.order 一致。
+
+#接口地址
+code
+POST /api/open/v1/orders/show
+#请求方式
+POST
+
+#请求参数
+Body 为 JSON 对象，二选一（不可同时为空）：
+
+参数名	类型	必填	说明
+platform_order_no	string	条件	您的业务单号（开放 API 订单）
+order_no	string	条件	平台内部单号
+#响应参数
+与 创建订单 的 data.order 字段相同，主要包括：
+
+参数名	类型	说明
+data.order.order_no	string	平台内部单号
+data.order.platform_order_no	string	您的业务单号
+data.order.platform	string	固定为 api
+data.order.product_name	string	商品名称
+data.order.recharge_status	number	充值状态码
+data.order.recharge_status_label	string	充值状态中文
+data.order.points_charged	number	扣除积分
+data.order.player_account	string	玩家 UID
+data.order.recharge_submit_at	string | null	提交时间
+data.order.recharge_finish_at	string | null	完成时间
+data.order.recharge_result_message	string | null	结果说明
+data.order.h5.entry_url	string	H5 兑换首页
+data.order.h5.recharge_url	string	充值/绑定 H5 链接
+#状态码
+值	含义
+15	待买家在 H5 提交信息
+17	买家已提交，处理中
+20	发货中
+30	成功
+40	失败
+50	需人工处理
+60	已取消
+#响应示例
+json
+{
+  "code": 0,
+  "message": "success",
+  "data": {
+    "order": {
+      "order_no": "202601011200001234",
+      "platform_order_no": "YOUR-ORDER-001",
+      "platform": "api",
+      "product_name": "和平精英点券",
+      "recharge_status": 30,
+      "recharge_status_label": "充值成功",
+      "status": 30,
+      "status_label": "充值成功",
+      "points_charged": 3800,
+      "player_account": "1234567890",
+      "created_at": "2026-01-01 12:00:00",
+      "product_code": "10000001",
+      "platform_buy_num": 1,
+      "player_game_region": "安卓",
+      "player_game_srv": "微信",
+      "player_game_role": "测试角色",
+      "recharge_bind_at": null,
+      "recharge_submit_at": "2026-01-01 12:01:00",
+      "recharge_finish_at": "2026-01-01 12:05:00",
+      "recharge_result_message": null,
+      "updated_at": "2026-01-01 12:05:00",
+      "h5": {
+        "entry_url": "http://skin-exchange.yiquyou.icu/h5/exchange",
+        "recharge_url": "http://skin-exchange.yiquyou.icu/h5/bind?code=..."
+      }
+    }
+  }
+}
+订单不存在时：
+
+json
+{
+  "code": 1,
+  "message": "订单不存在",
+  "data": {}
+}
+