On This Page
FILTER BY TAG

Multibanco

Multibanco enables customers to pay for a range of goods and services by bank transfer. These services include e-commerce, licenses, and taxes post-purchase. Multibanco is supported by all banks in Portugal.
When the total amount of the order is outside the range of accepted transaction amounts, the Multibanco payment button is not displayed in
Unified Checkout
. These are the accepted transaction amounts:
  • Minimum transaction amount
    : No minimum
  • Maximum transaction amount
    : EUR 99,999

Billing Details for Multibanco

The
captureMandate.billingType
 field value determines whether
Unified Checkout
 displays the full billing details form when Multibanco requires partial billing details.
When the
captureMandate.billingType
 field is set to
FULL
 and Multibanco requires partial billing details,
Unified Checkout
 displays the full billing details form.
  • If the merchant includes all required fields in the capture context request, and the billing country is compatible with the payment type, the consumer currency, or both, the consumer sees a billing summary confirmation screen.
  • If the merchant does not include all required fields in the capture context request, the consumer sees the full billing details form.
When the
captureMandate.billingType
 field is set to
PARTIAL
 and Multibanco requires partial billing details,
Unified Checkout
 displays the full billing details form.
  • If the merchant includes all required fields in the capture context request, and the billing country is compatible with the payment type, the consumer currency, or both, the consumer sees a billing summary confirmation screen.
  • If the merchant does not include all required fields in the capture context request, the consumer sees the full billing details form.

Opt in to Multibanco on
Unified Checkout

You can enable Multibanco from the
Unified Checkout
 merchant experience section in the
Business Center
. For information about how to enable Multibanco using the
Business Center
, see Configure Payment Options.
You can also enable Multibanco using the
Unified Checkout
v1/sessions
 API. Follow these steps to opt in to the Multibanco payment method using the API:
  1. Add Multibanco to your integration by adding
    MULTIBANCO
     to the
    allowedPaymentTypes
     field object within the capture context request.
  2. Set the
    completeMandate.type
     field value to
    CAPTURE
     or
    PREFER_AUTH
    .
    You can capture the funds immediately if you include the
    completeMandate.type
     field in the capture context request and set the value to
    CAPTURE
    .
    If you accept more than one payment type and must perform an authorization where funds are collected at a later time, set the
    completeMandate.type
     field to
    PREFER_AUTH
    . The funds are captured immediately for the online bank transfer.
  3. Include these required fields for online bank transfers in the capture context request:
    • data.orderInformation.billTo.country
    • data.orderInformation.billTo.firstName
    • data.orderInformation.billTo.lastName
  4. Include this optional field for online bank transfers in the capture context request:
    • data.orderInformation.billTo.address1
    • data.orderInformation.billTo.email
IMPORTANT
When you do not include the billing and shipping information in the capture context request, a pop-up will appear for the merchant to provide this information during checkout.
RELATED TO THIS PAGE