docs(weappPayBridge): 移除支付桥页测试参数并添加业务接入说明
移除 success_text、cancel_text、fail_text 等仅用于最小测试页的参数,使链接更简洁。 在代码注释中添加正式业务接入的详细步骤说明,包括支付结果查询和轮询策略。
Showing
1 changed file
with
12 additions
and
1 deletions
| ... | @@ -59,9 +59,20 @@ const isMiniProgramWebView = computed(() => { | ... | @@ -59,9 +59,20 @@ const isMiniProgramWebView = computed(() => { |
| 59 | return navigator.userAgent.includes('miniProgram'); | 59 | return navigator.userAgent.includes('miniProgram'); |
| 60 | }); | 60 | }); |
| 61 | 61 | ||
| 62 | +/** | ||
| 63 | + * 说明: | ||
| 64 | + * 当前页面只是「H5 -> 小程序支付桥页」的最小测试页,只负责把 order_id 传给外层小程序。 | ||
| 65 | + * 小程序桥页支付完成后,会通过 navigateBack 返回 WebView,但不会把支付结果主动回调给当前 H5 页面。 | ||
| 66 | + * | ||
| 67 | + * 如果后续要按正式业务接入 | ||
| 68 | + * 1. H5 发起支付前记录当前 order_id,并标记“等待支付结果”; | ||
| 69 | + * 2. 从小程序桥页返回后,在 pageshow / visibilitychange / focus 等时机触发查单; | ||
| 70 | + * 3. 调后端订单状态接口,以服务端订单状态作为最终支付结果; | ||
| 71 | + * 4. 如后端存在支付落账延迟,可按 1~2 秒间隔短轮询 3~5 次。 | ||
| 72 | + */ | ||
| 62 | const payBridgePagePath = computed(() => { | 73 | const payBridgePagePath = computed(() => { |
| 63 | const normalizedOrderId = encodeURIComponent(orderId.value || ''); | 74 | const normalizedOrderId = encodeURIComponent(orderId.value || ''); |
| 64 | - return `/pages/pay-bridge/index?order_id=${normalizedOrderId}&auto_back=1&back_delay=2&back_mode=navigateBack&back_url=${encodeURIComponent('/pages/webview-preview/index')}&success_text=${encodeURIComponent('支付成功,正在返回 WebView 页面。')}&cancel_text=${encodeURIComponent('已取消支付,正在返回 WebView 页面。')}&fail_text=${encodeURIComponent('支付未完成,正在返回 WebView 页面。')}&source=weapp-pay-bridge`; | 75 | + return `/pages/pay-bridge/index?order_id=${normalizedOrderId}&auto_back=1&back_delay=2&back_mode=navigateBack&back_url=${encodeURIComponent('/pages/webview-preview/index')}&source=weapp-pay-bridge`; |
| 65 | }); | 76 | }); |
| 66 | 77 | ||
| 67 | const ensureOrderId = () => { | 78 | const ensureOrderId = () => { | ... | ... |
-
Please register or login to post a comment