---
title: Bizum 跳转收银台集成
permalink: /notes/zh/paymentMethods/Bizum/hosted/
createTime: '2026/08/26 19:47:32'
description: >-
  介绍Bizum跳转收银台集成方法，适用于西班牙地区。通过API预下单获取支付链接，用户跳转至收银台选择Bizum，并在银行App中确认完成支付。支持48小时内未支付订单重新发起支付。
---

## Bizum-跳转收银台交互流程

```mermaid
sequenceDiagram
    actor User as 👤 用户
    participant Frontend as 💻 商户前端
    participant Backend as 🏪 商户后端
    participant PPC as 🔄 PingPongCheckout
    participant Bizum as 🏦 Bizum

    Note over User, Bizum: 🚀 Bizum 跳转收银台支付流程

    User->>Frontend: 1. 发起支付
    Frontend->>Backend: 2. 创建订单
    Backend->>+PPC: 3. 请求收银台预下单（paymentMethods: Bizum）
    PPC-->>-Backend: 4. 返回 paymentUrl
    Backend-->>Frontend: 5. 返回 paymentUrl
    Frontend->>Frontend: 6. 重定向到收银台页面

    User->>PPC: 7. 在收银台选择 Bizum
    PPC->>+Bizum: 8. 发起 Bizum 支付
    Bizum-->>-PPC: 9. 返回支付确认页

    User->>Bizum: 10. 输入 Bizum 注册手机号
    Bizum->>User: 11. 银行 App 弹出确认界面
    User->>Bizum: 12. 密码/指纹/面容 ID 授权
    Bizum->>Bizum: 13. 扣款（通常几秒内完成）

    alt ✅ 支付成功
        Bizum-->>PPC: 14. 🟢 支付成功
        PPC-->>Frontend: 15. 跳转支付结果页（payResultUrl）
        PPC--)Backend: 16. 📡 异步通知支付结果
        Backend--)PPC: 17. 🟢 响应 200
    else ❌ 支付失败
        Bizum-->>PPC: 14. ❌ 支付失败
        PPC-->>Frontend: 15. 跳转支付结果页
        PPC--)Backend: 16. 📡 异步通知支付结果
    end

    Note over User, Bizum: 🎯 Bizum 跳转收银台流程完成
```

## 集成导航

### 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="Bizum" :integrateType="'Hosted'" :scenario="'normal'" />

### Step2 渲染收银台

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

## 重新支付

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