Multibanco

Features
Method	Async - GET Redirect
Merchant countries	Europe
Consumer countries	Portugal
Processing currencies	EUR
Increments	-
Captures	-
Partial/Multiple partial captures	-
Cancels	-
Partial/Multiple partial cancels	-
Refunds	✅
Partial/Multiple partial refunds	✅
Recurring	-
Installments	-
Credits	-
Disputes	-
Max Amount	99,999.99
Min Amount	0.01
Account verification	-

Multibanco is a popular post-pay payment method in Portugal, allowing customers to pay for online purchases at their convenience using the Multibanco ATM network or online banking.

When a consumer shops online using the Multibanco payment method, the merchant sends a payment to the PSP.

The merchant redirects to the Multibanco page and allows the customer to get the voucher needed to complete the purchase.

Payment flow

Payment

Request

{
    "processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
    "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
    "amount": {
        "value": 200,
        "currency": "eur"
    },
    "paymentMethod": {
        "type": "multibanco",
        "multibanco": {
            "returnUrl": "https://merchant.site/complete-payment"
        }
    }
}

Response

{
    "id": "27yiW9MgzBtwiodreuNOXk0rtIw",
    "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
    "status": "pending",
    "trackingUrl": "/v1/tracks/payments/{trackId}",
    "reason": {
        "code": "required_next_step",
        "description": "An additional step is needed to complete the payment."
    },
    "nextStep": {
        "type": "redirect",
        "redirect": {
            "method": "get",
            "url": "https://payment.method/complete"
        }
    }
}