|
|
@@ -1,6 +1,8 @@
|
|
|
# OMG（歐買尬/FunPoint）支付 — 前端接入文档
|
|
|
|
|
|
-**适用端**：客户 App（uni-app） ｜ **后端分支**：`OmgPayController` 已完成 ｜ **日期**：2026-08-14
|
|
|
+> **2026-10-15 现行补充**：本页保留 016 初期接入说明；退款请求和返回语义以更新后的 §3.4 为准。无人接单自动取消与退款由后端任务处理，前端展示订单及退款状态即可。后端计时、测试环境限制见 [037 规格](../037-order-no-rider-auto-cancel/spec.md)。
|
|
|
+
|
|
|
+**适用端**：客户 App（uni-app） ｜ **后端入口**：`OmgPaymentController` ｜ **初版日期**：2026-08-14
|
|
|
|
|
|
---
|
|
|
|
|
|
@@ -151,23 +153,28 @@ App 返回后用 Header `token` 和 JSON `{"orderId":"..."}` 调用。接口只
|
|
|
|
|
|
### 3.4 退款（取消已支付订单）— `POST /pay/omg/refund`
|
|
|
|
|
|
-**用途**：用户取消已支付的信用卡/Apple Pay 订单时退款。
|
|
|
+**用途**：订单已取消且 OMG 实收后，登记退款意图。接口成功只表示意图已接受，正式环境由后台任务按网关状态异步退款；前端不能立即显示“已退款”。无人接单自动取消时由后端自行登记，前端无需主动调用本接口。
|
|
|
|
|
|
| 项 | 内容 |
|
|
|
|----|------|
|
|
|
| Method | `POST` |
|
|
|
| Header | `token: <用户JWT>` |
|
|
|
-| 入参 | query：`orderid` = ddId |
|
|
|
+| 入参 | JSON body：`{"orderId":"订单号"}` |
|
|
|
| 鉴权 | 订单本人 |
|
|
|
|
|
|
**请求**
|
|
|
```
|
|
|
-POST {baseURL}/pay/omg/refund?orderid=DD202608060001
|
|
|
+POST {baseURL}/pay/omg/refund
|
|
|
Header: token: eyJ...
|
|
|
+Content-Type: application/json
|
|
|
+
|
|
|
+{"orderId":"DD202608060001"}
|
|
|
```
|
|
|
|
|
|
**返回**
|
|
|
-| code=200 | 信用卡/Apple Pay 退刷成功，`pos_order.pay_status` 置 2 |
|
|
|
+| code=200 | 已登记退款意图；需继续查询订单/退款状态，不能据此认定资金已退回 |
|
|
|
+
|
|
|
+测试环境没有 OMG 信用卡真实退款能力，接口会返回不可退款错误；测试退款意图不会被标记为成功。正式环境需配置商户 CreditCheckCode 并完成真实网关联调，详见 [037 计划](../037-order-no-rider-auto-cancel/plan.md)。
|
|
|
|
|
|
---
|
|
|
|
qmj