---
title: Bizum Redirect Checkout Integration
permalink: /en/notes/paymentMethods/Bizum/hosted/
createTime: '2026/08/26 19:47:32'
description: >-
  This guide introduces Bizum redirect checkout integration for Spain. Obtain a
  payment link via the pre-order API, redirect the user to the checkout page to
  select Bizum, and confirm the payment in the banking app. Unpaid orders can be
  retried within 48 hours.
---

## Bizum Redirect Checkout Flow

```mermaid
sequenceDiagram
    actor User as 👤 User
    participant Frontend as 💻 Merchant Frontend
    participant Backend as 🏪 Merchant Backend
    participant PPC as 🔄 PingPongCheckout
    participant Bizum as 🏦 Bizum

    Note over User, Bizum: 🚀 Bizum Redirect Checkout Flow

    User->>Frontend: 1. Initiate payment
    Frontend->>Backend: 2. Create order
    Backend->>+PPC: 3. Request checkout pre-order (paymentMethods: Bizum)
    PPC-->>-Backend: 4. Return paymentUrl
    Backend-->>Frontend: 5. Return paymentUrl
    Frontend->>Frontend: 6. Redirect to checkout page

    User->>PPC: 7. Select Bizum on checkout
    PPC->>+Bizum: 8. Initiate Bizum payment
    Bizum-->>-PPC: 9. Return payment confirmation page

    User->>Bizum: 10. Enter Bizum registered mobile number
    Bizum->>User: 11. Banking app shows confirmation screen
    User->>Bizum: 12. Authorize with password / fingerprint / Face ID
    Bizum->>Bizum: 13. Process deduction (usually within seconds)

    alt ✅ Payment success
        Bizum-->>PPC: 14. 🟢 Payment success
        PPC-->>Frontend: 15. Redirect to result page (payResultUrl)
        PPC--)Backend: 16. 📡 Async payment notification
        Backend--)PPC: 17. 🟢 Respond 200
    else ❌ Payment failure
        Bizum-->>PPC: 14. ❌ Payment failure
        PPC-->>Frontend: 15. Redirect to result page
        PPC--)Backend: 16. 📡 Async payment notification
    end

    Note over User, Bizum: 🎯 Bizum Redirect Checkout Flow Complete
```

## Integration Guide

### Step1 Request <a href="/en/notes/checkout/api/reserve/" target="_blank">Checkout Pre-order</a>

In the response of the <a href="/en/notes/checkout/api/reserve/" target="_blank">Checkout Pre-order</a> API, you can obtain the `paymentUrl` to redirect to the checkout page.

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

### Step2 Render the Checkout

Redirect to the checkout page using the `paymentUrl` from Step1. See <a href="/en/notes/services/checkout/hosted/hosted/" target="_blank">Redirect to Checkout</a> for details.

## Repayment

If the payment is not completed on the checkout page, you can open the URL again to retry. A checkout URL is valid for 48 hours.