Managing emitted boletos


Available Providers

Not all Custody Providers support emitting Boletos, available assets: BRLD, BRLB.

You can find the boletos emitted to a wallet by providing some search filters, such as the wallet identifier, the start and end date of the period you want to query, and the boleto status, which can take one of the following values: EMITED, PAID or ALL.

const me = await bitcapital.users().me();
const myWallet = me.wallets[0];

const boletos = await bitcapital.boletos().find(
  filters: {
    start: "2019-09-19",
    end: "2019-10-19",
    type: "ALL"
  pagination: {
    skip: 1,    // page number
    limit: 10 // number of results per page

curl --location --request GET '' \
--header 'Content-Type: application/json'

Getting a single Boleto information

To retrieve the details of a boleto you must provide the boleto identifier, which can be be obtained by searching for boletos using filters, as shown on the previous page.

const boletoId = 'some_boleto_id';
const boletoDetails = await bitcapital.boletos().findOne(boletoId);

curl --location --request GET '' \
--header 'Content-Type: application/json'

Getting the current status from a single Boleto

The BS2 Provider suports a fine grained control of the status of the boleto, currently stating:




Boleto was created and is pending provider registration confirmation.


Boleto is fully registered and is pending payment.


Boleto was partially paid or its payment was scheduled for execution.


Boleto was fully paid and is pending execution.


Boleto was fully executed and the balance is available for payments.


Boleto was canceled by the provider or the issuer.


Boleto was expired before the payment.

Did this page help you?