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"
      }
   }
}

Properties

Remarks

redirectPaymentMethodSpecificInput PaymentProductId returnUrl requiresApproval

paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Overview" chapter. It instructs our platform to send your customers directly to the Bizum portal. If left out, our platform sends your customers to the Hosted Checkout Page instead, allowing them to choose this or any other payment method in your account returnURL: The URL we redirect your customers to after the payment has been finalised requiresApproval: Set to either "true"/"false" depending on whether you want to process payments in authorisation/direct sale mode If you set requiresApproval to "true", make sure to capture the transaction later via the Merchant Portal or a CapturePayment request. Only then will the transaction have status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, for which you receive the actual payment for the transaction Mind that Bizum supports only one final (partial) capture