Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Multibanco è una modalità di pagamento utilizzata in Portogallo. Multibanco consente ai consumatori di pagare una gamma di beni o servizi che include e-commerce, licenze e imposte tramite bonifico bancario o tramite la carta Multibanco presso un bancomat.
Multibanco è una delle modalità di pagamento tramite browser supportate nel Mastercard Gateway. In questa pagina vengono descritti i dettagli specifici dell'integrazione di Multibanco. Si consiglia di leggere le Linee guida per l'integrazione per il pagamento tramite browser prima di creare un'integrazione Multibanco.
Per offrire Multibanco come modalità di pagamento mediante il Mastercard Gateway:
L'integrazione di Hosted Checkout consente di raccogliere i dettagli di pagamento dal pagante tramite un'interazione ospitata e visualizzata dal gateway.
A partire dalla versione 65 dell'API, Multibanco è automaticamente disponibile come modalità di pagamento dopo che il your payment service provider ha abilitato e configurato l'esercente per questa modalità di pagamento.
Per ulteriori dettagli, vedere Pagamenti tramite browser mediante integrazione Hosted Checkout.
L'integrazione di Direct Payment consente di offrire la modalità di pagamento Multibanco sulla propria pagina di checkout.
Effettuare un richiesta Initiate Browser Payment
in cui sourceOfFunds.type = MULTIBANCO
e browserPayment.operation = PAY
(l'operazione Authorize non è supportata da Multibanco). Per i campi standard, vedere Pagamenti tramite browser mediante Integrazione Direct Payment.
I campi indicati di seguito sono restituiti nella risposta Initiate Browser Payment
/Retrieve Transaction
/Retrieve Order
dopo all'avvio di un pagamento Multibanco.
sourceOfFunds.provided.multibanco.entityId
: ID esercente presso Multibanco.sourceOfFunds.provided.multibanco.paymentReference
: Identificativo per il pagamento Multibanco.È necessario fornire questi campi al pagante per completare il pagamento.
È possibile impostare la lingua che si desidera sia utilizzata da Multibanco per le pagine mostrate al pagante fornendo il campo browserPayment.preferredLanguage
nella richiesta Initiate Browser Payment. Tuttavia, la lingua verrà utilizzata solo se supportata da Multibanco.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "browserPayment":{ "operation":"PAY", "returnUrl":"<your_merchant_URL>" }, "order":{ "amount":"10.00", "currency":"EUR" }, "sourceOfFunds":{ "type":"MULTIBANCO" } }
Nella tabella che segue sono illustrati i possibili scenari per i codici di risposta della transazione restituiti dopo l'avvio di un pagamento Multibanco.
Risposta Initiate Browser Payment |
Cosa significa... |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Reindirizzare il pagante utilizzando l'URL fornito nella risposta. |
Risposta di Retrieve Transaction/Retrieve Order |
Cosa significa... |
response.gatewayCode=APPROVED result=SUCCESS sourceOfFunds.provided.multibanco.terminalLocation sourceOfFunds.provided.multibanco.terminalId |
Il pagamento è avvenuto correttamente. |
response.gatewayCode= PENDING result=PENDING |
Il Mastercard Gateway sta aspettando una notifica dall'acquirer sul risultato del pagamento. Riprovare RETRIEVE_TRANSACTION più tardi o controllare le notifiche del Mastercard Gateway. |
response.gatewayCode= CANCELLED result=FAILURE |
Il pagante ha annullato l'interazione per il pagamento. Offrire al pagante la possibilità di provare ad utilizzare un'altra modalità di pagamento. |
response.gatewayCode= DECLINED or ACQUIRER_SYSTEM_ERROR result=FAILURE |
Il pagamento è stato rifiutato. Offrire al pagante la possibilità di provare ad utilizzare un'altra modalità di pagamento. In presenza di un ACQUIRER_SYSTEM_ERROR è possibile richiedere all'acquirer il motivo dell'esito negativo del pagamento, oppure riprovare RETRIEVE_TRANSACTION . |
response.gatewayCode=TIMED_OUT result=FAILURE |
Considerare questo pagamento come rifiutato. Il gateway effettuerà un tentativo per garantire che la transazione non abbia esito positivo o revocherà la transazione. |
Il Mastercard Gateway fornisce un simulatore di pagamento tramite browser che consente di verificare la propria integrazione Multibanco.