Multibanco via Worldpay

​

Supported workflows

​

Before you begin

1. Set up a Worldpay integration in your workspace. Contact your Payrails account team if Worldpay isn’t listed in your Payrails Portal 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.
• Refunds aren’t available for Multibanco payments through Worldpay.
• Save Instruments and MIT aren’t available for Multibanco through Worldpay.