How you add Multibanco depends on your integration.
Choose the server-side flow that your integration uses:
Start integrating with Sessions flow Drop-in
Choose your versionRequirements
| Requirement | Description |
|---|---|
| Integration type | Make sure that you have an existing Sessions flow Drop-in integration. Required version of Checkout API: v68 or later. |
| Setup steps | Before you begin, add Multibanco in your Customer Area. |
Add additional parameters to your /sessions request
You do not need to add any parameters when you create a payment session.
Add additional configuration for Multibanco
Add a configuration object with the following parameters:
| Parameter | Required | Description |
|---|---|---|
setSubmitButtonVisible |
Set if you want the submit button to be visible. |
{ setSubmitButtonVisible(True) }
Test and go live
Before you can test Multibanco payments, you need to submit a request for Multibanco in your test Customer Area.
In the test environment, you can simulate a Multibanco payment by promoting the pending payment to a sale.
- Log in to your test Customer Area.
- Go to Transactions > Offers.
- Select the PSP reference of the pending Multibanco payment.
- Select Promote offer to sale button.
Multibanco payments that have been paid (including test offers that you manually promoted to sale) are under Transactions > Payments.
Test the reconciliation process by promoting test payments from offer to sale in your test Customer Area.
Before you can accept live Multibanco payments, you need to submit a request for Multibanco in your live Customer Area.