Multibanco via Worldpay

​

Supported workflows

​

Before you begin

1. Set up a Worldpay integration in your workspace. Follow the Worldpay integration setup guide if you don’t have one yet.
2. Ask Worldpay to enable Multibanco on your Worldpay entity.
3. In the Payrails Portal, go to Settings → Integrations, open your Worldpay integration, select Multibanco under Payment methods, and save.
4. Add Multibanco as a payment option in your workflow.

​

Request fields for Worldpay

​

Authorize a Multibanco payment

{
  "amount": {
    "value": "25.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "multibanco",
      "amount": {
        "value": "25.00",
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "order": {
      "reference": "order-1234",
      "softDescriptor": "Example Store",
      "billingAddress": {
        "email": "ines.costa@example.com",
        "country": {
          "code": "PT"
        }
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Worldpay handles Multibanco

• When the customer returns from the redirect, Payrails reads the result from the return URL, because Worldpay doesn’t add a payment status to it. A pending result leaves the payment pending until the Worldpay webhook sets the final status.
• Payrails reads the customer’s email from meta.order.billingAddress.email, not from meta.customer.email.
• Each Multibanco payment is a new customer-initiated payment.