Multibanco

Features
Method	Async
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.

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": "display_voucher",
        "display_voucher": {
            "type": "multibanco",
            "reference": "679115881",
            "entity": "11893"
        }
    }
}