---
title: WeChat Pay 跳转收银台集成
permalink: /notes/zh/paymentMethods/WeChatPay/hosted/
createTime: '2025/08/08 14:30:00'
description: >-
  介绍WeChat
  Pay跳转收银台集成方法，适用于中国大陆地区。通过API预下单获取支付链接，用户跳转至微信支付页面完成支付。支持48小时内未支付订单重新发起支付。
---

## WeChat Pay-跳转收银台交互流程

```mermaid
%%{init: {
'theme': 'base',
'themeVariables': {
'primaryColor': '#E3F2FD',
'primaryTextColor': '#0D47A1',
'primaryBorderColor': '#1976D2',
'lineColor': '#1565C0',
'secondaryColor': '#BBDEFB',
'tertiaryColor': '#90CAF9',
'background': '#F8FBFF',
'mainBkg': '#E3F2FD',
'secondBkg': '#BBDEFB',
'tertiaryBkg': '#90CAF9',
'actorBkg': '#2196F3',
'actorBorder': '#1976D2',
'actorTextColor': '#FFFFFF',
'actorLineColor': '#1565C0',
'signalColor': '#0D47A1',
'signalTextColor': '#0D47A1',
'c0': '#E8F4FD',
'c1': '#D1E7DD',
'c2': '#B3D9FF',
'c3': '#81C784',
'noteBkgColor': '#E1F5FE',
'noteTextColor': '#01579B',
'noteBorderColor': '#0288D1',
'loopTextColor': '#0D47A1',
'activationBkgColor': '#B3E5FC',
'activationBorderColor': '#0277BD'
}
}}%%

sequenceDiagram
participant User as 👤 用户
participant Frontend as 💻 商户前端
participant Merchant as 🏪 商户后端
participant PP as 🔄 PingPong服务端
participant Hosted as 🌐 PingPong收银台
participant WeChat as 💬 WeChat Pay

    Note over User, WeChat: 🚀 WeChat Pay跳转收银台集成流程

    Note over Merchant, Frontend: 📋 准备阶段:• 获取收银台链接

    Merchant->>+PP: 1. 调用收银台预下单接口
    Note right of PP: 生成支付链接(paymentUrl)
    PP-->>-Merchant: 2. 返回paymentUrl

    Merchant->>Frontend: 3. 传递paymentUrl到前端

    User->>Frontend: 4. 点击支付按钮
    Frontend->>+Hosted: 5. 直接跳转到PingPong收银台
    Note right of Frontend: 使用paymentUrl直接跳转

    Hosted->>Hosted: 6. 初始化收银台界面
    Note right of Hosted: • 显示可用的支付方式列表

    Hosted-->>-Frontend: 7. 收银台加载完成

    User->>Hosted: 8. 选择WeChat Pay支付

    alt PC端支付流程
        Hosted->>+WeChat: 9. a 生成微信支付二维码
        WeChat-->>-Hosted: 10. 返回支付二维码
        Hosted-->>User: 11. 展示支付二维码
        User->>User: 12. 使用手机扫描二维码
        User->>WeChat: 13. 在手机微信中确认支付
    else 手机端支付流程
        Hosted->>+WeChat: 14. b 请求拉起微信App支付
        WeChat-->>-Hosted: 15. 返回拉起参数
        Hosted-->>User: 16. 调起微信App
        User->>WeChat: 17. 在微信App中确认支付
    end
    
    WeChat->>PP: 18. 支付结果通知
    
    PP->>PP: 19. 处理支付

    alt ✅ 支付成功
        PP-->>Hosted: 20. 🎉 支付成功
        Hosted->>Hosted: 21. 显示成功页面
        Hosted-->>Frontend: 22. 页面回调(payResultUrl)
        Frontend-->>User: 23. 展示支付成功页面
    else ❌ 支付失败
        PP-->>Hosted: 24. ❌ 支付失败
        Hosted->>Hosted: 25. 显示错误页面
        Hosted-->>Frontend: 26. 错误回调
        Frontend-->>User: 27. 展示支付失败信息
    end

    PP-->>Merchant: 28. 异步通知支付结果
    Note right of Merchant: 接收并处理<br/>支付结果通知

    Note over User, WeChat: 🎯 WeChat Pay跳转收银台流程完成
```
## 集成导航

### Step1 请求<a href="/notes/zh/checkout/api/reserve/" target="_blank">收银台预下单</a>

在API<a href="/notes/zh/checkout/api/reserve/" target="_blank">收银台预下单</a>的响应中，您可以获取`paymentUrl`用于跳转收银台

<v4-v2-PaymentMethods-ParamsOptimized paymentMethod="WechatPay" :integrateType="'Hosted'" :scenario="'normal'" />

### Step2 渲染收银台

使用Step1获取的`paymentUrl`跳转收银台，接入文档:<a href="/notes/zh/services/checkout/hosted/hosted/" target="_blank">跳转收银台</a> 

## 重新支付

收银台若未支付成功，可以手动打开URL再次发起支付，一个收银台URL有效时长为48小时