Bizum is a widely used payment method in Spain that enables fast and secure money transfers and payments. With Bizum, users can pay for different purposes, such as transferring money to friends, paying online purchases, or settling bills. Bizum integrates directly with users' existing bank accounts, eliminating the need for cash or card details or to load funds onto a third-party platform. The process is straightforward: customers provide their mobile phone number, receive a notification, and confirm the transaction.

It particularly benefits users who value speed and simplicity, as transactions are completed in real time. For Bizum, merchants/PSPs gain access to two flexible integration options via PPRO:

REDIRECT (Basic Out-of-the-box Option): PPRO’s Hosted Payment Page providing the Bizum UX via Redirect, including requesting the shopper’s phone number and initiating the payment;

APP_NOTIFICATION (Advanced Solution For Embedded Experience): This option enables merchants/PSPs to embed the UX of capturing the customer phone number in their checkout experience and then use the phone number to initiate the request towards PPRO via APP Notification.

Bizum’s versatility and ease of use makes it an ideal for consumers and businesses seeking a hassle-free payment solution.

Payment Method Properties

Bizum Integration

Transaction - REDIRECT (Host Payment Page) Flow

Payment Initiation

1. Payment Selection: On the Merchant's checkout page, the Consumer selects Bizum as their preferred payment method and initiates the payment request.
2. Payment Initiation: The Merchant forwards the payment initiation request to PPRO.
3. Host Payment Page Generation: PPRO generates a Host Payment Page designed to capture the Consumer's Bizum phone number.
4. Host Payment Page Address: PPRO returns the Host Payment Page URL to the Merchant.
5. Consumer Redirection: The Merchant redirects the Consumer to the Host Payment Page using the provided URL.

Host Payment Page

6. The Consumer is redirected to the Host Payment Page;
7. The Consumer visualizes the Host Payment Page and is prompted to enter their Bizum-associated phone number;
8. The Consumer submits their phone number.
9. PPRO forwards the transaction request to the Bizum provider.
10. Bizum responds to PPRO with a PENDING status.
11. Redirect to Success Page: PPRO redirects the Consumer to a success page, indicating that the transaction is in a PENDING state.

Application Interaction

12. Payment Confirmation Notification: The Consumer receives a notification on their banking application prompting them to confirm the payment.
13. Consumer Confirmation: The Consumer confirms the payment through their banking application.

Internal Confirmation

14. Bizum notifies PPRO about the confirmed payment.
15. PPRO confirmed the notification.
16. PPRO updates the transaction status to SUCCESS.

Make a Bizum REDIRECT payment

To make a Bizum payment, you'll need to provide the following data at minimum when calling our /v1/payment-charges API:

Request

POST /v1/payment-charges

{
    "paymentMethod": "BIZUM",
    "amount": {
        "value": 100,
        "currency": "EUR"
    },
    "consumer": {
        "name": "John Smith",
        "country": "ES"
    },
    "authenticationSettings": [
        {
            "type": "REDIRECT",
            "settings": {
                "returnUrl": "https://www.your-merchant-success-page.com/"
            }
        }
    ]
}

Response

{
  "id": "charge_X0O78tadFHrZCbGhkycPk",
  "status": "AUTHENTICATION_PENDING",
  
  // ...
  
  "authenticationMethods": [
    {
      "type": "REDIRECT",
      "details": {
        "requestUrl": "https://redirection-target.com",
        "requestMethod": "GET"
      }
    }
  ]
}

Transaction – APP_NOTIFICATION - Advanced Flow

Payment Initiation

1. Payment Selection: On the Merchant's checkout page, the Consumer selects Bizum as their preferred payment method, provides its phone number, and initiates the payment request.
2. Payment Initiation: The Merchant forwards the payment initiation request to PPRO.
3. PPRO forwards the transaction request to the Bizum provider.
4. Bizum responds to PPRO with a PENDING status.
5. Merchant responds with a PENDING status.
6. Merchant Portal indicates the success to the consumer.

Application Interaction

7. Payment Confirmation Notification: The Consumer receives a notification on their banking application prompting them to confirm the payment.
8. Consumer Confirmation: The Consumer confirms the payment through their banking application.

Internal Confirmation

9. Bizum notifies PPRO about the confirmed payment.
10. PPRO confirmed the notification.
11. PPRO updates the transaction status to SUCCESS.

Make a Bizum APP_NOTIFICATION payment

To make a Bizum payment, you'll need to provide the following data at minimum when calling our /v1/payment-charges API:

Request

POST /v1/payment-charges

{
    "paymentMethod": "BIZUM",
    "amount": {
        "value": 100,
        "currency": "EUR"
    },
    "consumer": {
        "name": "John Smith",
        "country": "ES"
    },
    "authenticationSettings": [
        {
            "type": "APP_NOTIFICATION",
            "settings": {
                "instrumentProviderIdentity": "+34700000000"
            }
        }
    ]
}

Response

{
  "id": "charge_X0O78tadFHrZCbGhkycPk",
  "status": "AUTHENTICATION_PENDING",
  
  // ...
}

Refund Flow

There are no specific parameters for Bizum integration.
For standard Global API Refund flow, see input parameters for the REFUND call.