---
title: Bizum Server To Server 集成
permalink: /notes/zh/paymentMethods/Bizum/s2s/
createTime: '2026/08/26 19:47:32'
description: >-
  Bizum Server To Server集成文档介绍了如何通过S2S方式实现Bizum支付。适用于西班牙地区PC端与移动端浏览器支付场景，关键参数包括device.orderTerminal和shopperIP。下单后返回paymentRedirectUrl，重定向后消费者在银行App中确认完成支付。
---

## Bizum-Server To Server交互流程

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

    Note over User, Bizum: 🚀 Bizum Server To Server 支付流程

    User->>Frontend: 1. 发起支付
    Frontend->>Backend: 2. 创建订单
    Backend->>+PPC: 3. 调用下单并支付（paymentMethod.type: Bizum）
    PPC-->>-Backend: 4. 返回 paymentRedirectUrl
    Backend-->>Frontend: 5. 返回 paymentRedirectUrl
    Frontend->>User: 6. 重定向到 Bizum 支付确认页

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

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

    Note over User, Bizum: 🎯 Bizum Server To Server 流程完成
```

## 集成导航

### Step1 调用<a href="/notes/zh/onlinePayment/auth/" target="_blank">下单并支付</a>

使用<a href="/notes/zh/onlinePayment/auth/" target="_blank">下单并支付</a>接口直接发起 Bizum 支付

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

### Step2 处理支付响应

下单并支付接口受理成功后返回 `code: 002000`（Transaction processing），`bizContent` 关键参数：

- `action.paymentRedirectUrl`：Bizum 支付确认页地址（`action.type` 为 `PAYMENT_REDIRECT_URL`），重定向到该页面后，消费者输入已在 Bizum 系统注册并激活的手机号，并在其银行 App 内通过密码或生物识别完成授权支付。**session 超时时间为 30 分钟，OTP 操作限时 4 分钟**，超时后需重新发起支付
- `status`：交易状态，受理后为 `PROCESSING`（处理中），最终支付结果以异步通知为准
- `exchangedAmount` / `exchangedCurrency`：换汇后的交易金额与币种
- `transactionId`：PingPong 交易号，用于对账与查询