On this page, you can find additional configuration for adding Bizum to your Components integration.
Before you begin
To activate Bizum, complete the following:
- Contract with a local supported bank (this is the acquirer).
Visit Bizum's official site to see a list of available banks. - Receive your MID and Terminal ID from the acquirer.
MID is also referred to as FUC. - Inform the acquirer that Adyen will process payments for you so they can connect your MID with Adyen as a gateway.
Adyen's IPSP number for e-commerce and Bizum operations is 31710.
After receiving your MID and Terminal ID from the acquirer, and before configuring Bizum, complete the following:
- Build your Components integration.
- Add Bizum in your Customer Area.
You cannot add Bizum in your Customer Area until you have your MID and Terminal ID.
API reference
Include fields for the endpoint you integrated:
The /sessions
workflow is the default with Components v5.0.0 or later.
Parameter name | Required | Description |
---|---|---|
reference | ![]() |
Your unique reference for the payment. Your reference must match the following regular expression: ^[a-zA-Z0-9]{4,125}$) |
Component configuration
Step 1: Create a DOM element
Create a DOM element on your checkout page, placing it where you want the payment method form to be rendered:
<div id="bizum-container"></div>
Step 2: Create an instance of the Component
Use the create
method of your AdyenCheckout
instance, in this case checkout
, to create the Component:
const bizumComponent = checkout.create('bizum').mount('#bizum-container');
Test and go live
To test Bizum, use the following guidelines:
- Use
telephoneNumber
: 700 000 000. - The
amount
value must be ≤ €15.
All payments above €15 are rejected in the Test environment.
Check the status of Bizum verification payments in your Customer Area > Transactions > Payments.