hookehuyr

docs(weappPayBridge): 移除支付桥页测试参数并添加业务接入说明

移除 success_text、cancel_text、fail_text 等仅用于最小测试页的参数,使链接更简洁。
在代码注释中添加正式业务接入的详细步骤说明,包括支付结果查询和轮询策略。
......@@ -59,9 +59,20 @@ const isMiniProgramWebView = computed(() => {
return navigator.userAgent.includes('miniProgram');
});
/**
* 说明:
* 当前页面只是「H5 -> 小程序支付桥页」的最小测试页,只负责把 order_id 传给外层小程序。
* 小程序桥页支付完成后,会通过 navigateBack 返回 WebView,但不会把支付结果主动回调给当前 H5 页面。
*
* 如果后续要按正式业务接入
* 1. H5 发起支付前记录当前 order_id,并标记“等待支付结果”;
* 2. 从小程序桥页返回后,在 pageshow / visibilitychange / focus 等时机触发查单;
* 3. 调后端订单状态接口,以服务端订单状态作为最终支付结果;
* 4. 如后端存在支付落账延迟,可按 1~2 秒间隔短轮询 3~5 次。
*/
const payBridgePagePath = computed(() => {
const normalizedOrderId = encodeURIComponent(orderId.value || '');
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`;
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`;
});
const ensureOrderId = () => {
......