Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Boleto Bancário è un sistema di pagamento per l'e-commerce utilizzato in Brasile che consente al pagante di effettuare acquisti sia con pagamenti in contanti sia con pagamenti bancari online. Quando il pagante seleziona Boleto Bancário sulla pagina di checkout e procede al pagamento in contanti, i dettagli di pagamento sono visualizzati sullo schermo e possono essere stampati. Il pagante può quindi pagare l'importo richiesto per l'acquisto presso un punto di pagamento Boleto Bancário. Per i pagamenti bancari online, il pagante immette i dettagli relativi a Boleto Bancário, riesamina e autorizza il pagamento. In entrambi i casi, una volta effettuato il pagamento, l'esercente riceverà una notifica e potrà rilasciare i beni per la spedizione al pagante.
Boleto Bancário è una delle modalità di pagamento tramite browser supportate nel Mastercard Gateway. In questa pagina vengono descritti i dettagli specifici dell'integrazione di Boleto Bancário. Si consiglia di leggere le Linee guida per l'integrazione per il pagamento tramite browser prima di creare un'integrazione Boleto Bancário.
I pagamenti tramite browser Boleto Bancário sono supportati solo per le transazioni nella valuta USD.
Per offrire Boleto Bancário come modalità di pagamento mediante il Mastercard Gateway:
Boleto Bancário tramite Hosted Checkout sarà presto disponibile. Si prega di contattare il your payment service provider per maggiori informazioni.
L'integrazione di Direct Payment consente di offrire la modalità di pagamento Boleto Bancário sulla propria pagina di checkout.
Oltre ai campi standard obbligatori in una richiesta di pagamento tramite browser, specificare i seguenti campi nella richiesta Initiate Browser Payment
:
sourceOfFunds.type
= BOLETO_BANCARIO
browserPayment.operation
= PAY
(l'operazione Authorize non è supportata da Boleto Bancário)billing.address.*
: i dettagli dell'indirizzo di fatturazione del pagante.customer.email
: l'indirizzo e-mail del pagante.customer.account.id
: l'identificativo per il conto del pagante.customer.nationalId
: un identificativo univoco per il pagante assegnato da un'autorità governativa. sourceOfFunds.provided.boletoBancario.bankAccountHolder
: il nome del titolare del conto corrente bancario del pagante.È possibile impostare la lingua che si desidera sia utilizzata da Boleto Bancário 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 Boleto Bancário.
{ "apiOperation": "INITIATE_BROWSER_PAYMENT", "billing": { "address": { "street": "10 Upper Bank Street", "postcodeZip": "E14 5NP", "city": "London", "country": "GBR" } }, "browserPayment": { "operation": "PAY", "returnUrl": "<your_merchant_URL>" }, "customer": { "email": "john.smith@example.com", "account": { "id": "1234567890" }, "nationalId": "1234567890" }, "order": { "amount": "10.00", "currency": "USD" }, "sourceOfFunds": { "type": "BOLETO_BANCARIO", "provided": { "boletoBancario": { "bankAccountHolder": "John Smith" } } } }
Nella tabella che segue sono illustrati i possibili scenari per i codici di risposta della transazione restituiti dopo l'avvio di un pagamento Boleto Bancário.
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 |
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 o 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 Mastercard Gateway tenterà di 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 Boleto Bancário.