Bizum

Countries & currencies

Supported countries

• Spain

Supported currencies

• Euro (EUR)

Integration

We offer this payment methods for the following integration modes. Learn in our dedicated guides about their individual differences:

• Hosted Checkout Page
• Server-to-server

Find a high level overview in the "Process flows" chapter.

Hosted Checkout Page/Server-to-server

Add the following properties to a standard CreateHostedCheckout/CreatePayment request:

{
   "order":{
      "amountOfMoney":{
         "currencyCode":"EUR",
         "amount":980
      },
      "customer":{
         "locale":"en_GB"
      }
   },
   "redirectPaymentMethodSpecificInput":{
      "PaymentProductId":5001,
      "RequiresApproval":false,
      "redirectionData":{
         "returnUrl":"https://yoururl.com"
      }
   }
}

Process flows

1. Your customers finalise an order in your shop and select Bizum.
2. You send this CreateHostedCheckout/CreatePayment request to our platform.
3. You redirect your customers via the redirectUrl (For CreateHostedCheckout requests) or merchantAction.redirectData.redirectURL (For CreatePayment requests). If your customers have the Bizum app installed on their device, it opens the app automatically.
   Your customers enter their personal data (phone number and password) to confirm the order.
4. Our platform receives the transaction result. Based on the configuration that Redsys has set up and activated, two scenarios are possible: 
   a.  Bizum redirects your customers to the Redsys intermediate page, displaying the transaction's authorisation code. Your customers confirm the redirection to the  returnURL.
   b. Bizum redirects your customers to returnURL.
5. You request the transaction result from our platform via GetPayment or receive the result via webhooks. If you process transactions via flow 4b, you get the transaction's authorisation code via property redirectPaymentMethodSpecificOutput.PaymentProduct5001SpecificOutput.authorisationCodefrom our platform via the GetPayment/webhooks request. Make sure to display this code on your returnURL.
6. If the transaction was successful, you can deliver the goods / services.

Testing

Refer to our Test cases for test data and detailed instructions.

Additional information

You can activate Bizum in the following ways:

• In test with Direct simulator
• In test with end-to-end testing
• In live for real transaction processing

Activate in test account with Direct simulator

This allows you to send transaction requests to our test environment and perform test as described in our Testing tab. These transactions do not have a financial impact.

Follow these steps:

1. Login to your test account. Go to Configuration > Payment methods > Choose new payment methods.
2. In "Additional filter criteria", go to "Web Banking". In the table, click on "Add" next to "Bizum".
3. In the "Contract data" tab, fill in the following properties:
   

   Property	Description/Actions
   UID	Enter any 8-digit numerical value.
   TID	Enter any 3-digit numerical value.
   Secret Key	Enter one of these SHA-256 SecretKey strings: VmFsaWRCaXp1bUtleUluMjRQb3MwMDAx Qml6dW1LZXlJbjI0UG9zMDAwMlZhbGlk S2V5SW4yNFBvczAwMDNWYWxpZEJpenVt SW4yNFBvczAwMDRWYWxpZEJpenVtS2V5 MjRQb3MwMDA1VmFsaWRCaXp1bUtleUlu UG9zMDAwNlZhbGlkQml6dW1LZXlJbjI0 MDAwN1ZhbGlkQml6dW1LZXlJbjI0UG9z

4. Click on "SUBMIT" to confirm.
5. Go to the "PM activation" tab. In "Activation", select the "Yes" radio button.
6. Click on "SUBMIT" to confirm. Bizum is now active in your test account.

Activate in test account with end-to-end testing

This allows you to send transaction requests to our test environment. Our platform sends your requests to the Bizum test environment to process your transactions. These transactions do not have a financial impact.

Follow these steps:

1. Login to your test account. Go to Configuration > Payment methods > Choose new payment methods.
2. In "Additional filter criteria", go to "Web Banking". In the table, click on "Add" next to "Bizum".
3. In the "Contract data" tab, fill in the following properties:
   

   Property	Description/Actions
   UID	Enter the 8-digit Unique Identifier you have received from Bizum.
   TID	Enter the 3-digit Terminal ID you have received from Bizum.
   Secret Key	Enter the SHA-256 SecretKey you have received from Bizum.

4. Click on "SUBMIT" to confirm.
5. Go to the "PM activation" tab. In "Activation", select the "Yes" radio button.
6. Click on "SUBMIT" to confirm. Bizum is now active in your test account in end-to-end testing mode.

Activate in live for real transaction processing

This allows you to send transaction requests to our live environment. Our platform sends your requests to the Bizum live environment to process your transactions. These transactions have a financial impact.

Follow these steps:

1. Login to your live account. Go to Configuration > Payment methods > Choose new payment methods.
2. In "Additional filter criteria", go to "Web Banking". In the table, click on "Add" next to "Bizum".
3. In the "Contract data" tab, fill in the following properties:
   

   Property	Description/Actions
   UID	Enter the 8-digit Unique Identifier you have received from Bizum.
   TID	Enter the 3-digit Terminal ID you have received from Bizum.
   Secret Key	Enter the SHA-256 SecretKey you have received from Bizum.

4. Click on "SUBMIT" to confirm.
5. Go to the "PM activation" tab. In "Activation", select the "Yes" radio button.
6. Click on "SUBMIT" to confirm. Bizum is now active in your live account in end-to-end live mode.