Bizum via Redsys

​

Supported workflows

​

Before you begin

1. Set up a Redsys integration in your workspace. Follow the Redsys integration setup guide if you don’t have one yet.
2. Ask your acquiring bank to activate Bizum on the Redsys terminal you use with Payrails.
3. In the Payrails Portal, go to Settings → Integrations, open your Redsys integration, select Bizum under Payment methods, and save.
4. Add Bizum as a payment option in your workflow.

​

Request fields for Redsys

​

Authorize a Bizum payment

{
  "amount": {
    "value": "25.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "bizum",
      "amount": {
        "value": "25.00",
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Lucía",
      "lastName": "García",
      "phone": {
        "countryCode": "34",
        "number": "612345678"
      }
    },
    "order": {
      "description": "Order 4821"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Redsys handles Bizum

• Payrails sends Redsys a Bizum request to pay, addressed to the customer’s phone number with its dialing code.
• Payrails checks that both the phone number and the dialing code are present before it calls Redsys.
• A Bizum payment needs no redirect and no 3D Secure. Payrails keeps the payment pending until Redsys sends the final result as a notification.
• With instant capture, Redsys charges the customer as soon as they approve the payment. With manual capture, the customer approves the payment first, and Redsys charges it when you capture the payment.
• Refunds go back to the customer’s bank account through Redsys.
• Each Bizum payment is a new customer-initiated payment.