Payment-method icon

Bizum Drop-in integration

Add Bizum to an existing Drop-in integration.

On this page, you can find additional configuration for adding Bizum to your Drop-in 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 Drop-in 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 following fields are required when making a /sessions request:

    Parameter name Required Description
    reference -white_check_mark- Your unique reference for the payment.
    Your reference must match the following regular expression: ^[a-zA-Z0-9]{4,125}$)

    Drop-in configuration

    There are no configuration steps specific to Bizum required for Drop-in.

    Test and go live

    To test Bizum payments:

    • Use telephoneNumber: 700 000 000.

    • Note that the payments amount value determines the outcome:

      Amount Outcome
      Less than 15 Payment is authorized
      From 15 to 50 Payment is refused
      From 50 to 1000 Payment is authorized
      More than 1000 Payment is refused

    • Check the status of Bizum test payments in your Customer Area > Transactions > Payments.

    See also