To maximize your conversion, especially on mobile devices, we highly recommend you to just display the barcode number at the checkout process and display a link instead the re-direct described here.
This allows your consumer to still have access to the full Boleto, hosted in the banking environment, at the same time by displaying the Boleto digitable line it helps your shopper to just copy & paste the number into their mobile banking app to proceed with the corresponding payment of the Boleto.
When a Boleto is generated we are sending you a response and a webhook containing all relevant information that allows you to proceed with the above scenario.
Boleto webhook sample upon creation:
{
"type":"PAYMENT",
"payload":{
"id":"8ac9a4a66e3fe4cf016e419f7a273d01",
"paymentType":"PA",
"paymentBrand":"BOLETO",
"amount":"33.99",
"currency":"BRL",
"presentationAmount":"33.99",
"presentationCurrency":"BRL",
"descriptor":"TEST MERCHANT 0977.3702.6177",
"merchantTransactionId":"e344001f842114cab3caf154e38f8f8a",
"result":{
"code":"000.000.000",
"description":"Transaction succeeded",
"randomField80570240":"Please allow for new unexpected fields to be added"
},
"resultDetails":{
"ExtendedDescription":"Payment method ready to be captured",
"clearingInstituteName":"CieloBoletoV3",
"BarCodeNumber":"23790837246097737026517000472807480680000003399",
"connectorId":"c39759f5-fe57-40e6-84e9-5366a294a124",
"ConnectorTxID2":"0977.3702.6177",
"DigitableLine":"23790.83724 60977.370265 17000.472807 4 80680000003399",
"AcquirerResponse":"1",
"reconciliationId":"0977.3702.6177"
},
"customer":{
"givenName":"Test",
"surname":"Test",
"email":"test@test.com.br",
"identificationDocType":"TAXSTATEMENT",
"identificationDocId":"00000000000",
"ip":"192.168.0.15"
},
"billing":{
"street1":"Av Brigadeiro Faria Lima 1111 Itaim Bibi",
"city":"Sao Paulo",
"state":"SP",
"postcode":"69400-11",
"country":"BR"
},
"authentication":{
"entityId":"8a8394c34e490569014e62e649b95062"
},
"customParameters":{
"BRADESCO_datavencimento":"09112019",
"BRADESCO_cpfsacado":"000000000000"
},
"redirect":{
"url":"https://transaction.pagador.com.br/post/pagador/reenvia.asp/c39759f5-fe57-40e6-84e9-5366a294a124",
"parameters":[
]
},
"risk":{
"score":""
},
"timestamp":"2019-11-06 16:50:02+0000",
"ndc":"8a8394c34e490569014e62e649b95062_86af5fd4c7db4520828f69d8b8132af6",
"merchantAccountId":"8acda4c75e3209e2015e32a19463092f"
}
}
"DigitableLine":"23790.83724 60977.370265 17000.472807 4 80680000003399"
The digitable line is the only number required in order for a consumer to proceed with the payment in their respective online banking app. This is applicable to all Brazilian banks independent of who the issuer of the Boleto is.
The url is the one you can use to display a link to the actual Boleto to be downloaded by the consumer if required.
Place of Payment | % of all paid Boletos |
|---|---|
Cashier in a bank branch | 7% |
ATM | 8.6% |
Internet Banking (Desktop) | 16.3% |
Mobile Application | 57.4% |
Other physical locations | 10.8% |