Emitting Boletos for deposits

To issue a Boleto for account recharging on behalf of the account holder you must provide the amount, the account holder's wallet identifier and optionally the due date.

curl --location --request POST 'https://<<instance>>/boletos/emit' \
--header 'Content-Type: application/json' \
--header 'X-Request-Signature: 00000000000000000000000000000000' \
--header 'X-Request-Timestamp: 1594219231752' \
--header 'Authorization: Bearer BEARER_TOKEN' \
--data-raw '{
    "destination": "c7bb518e-86a0-40be-b0f1-5f6715ac6cdc",
    "asset": "BRLB",
    "amount": "1.00",
    "expiresAt": "2022-08-04T12:00:00.000Z"
}'
{
    "barCode": "23794000000000000003391090108000119500076740",
    "digitableLine": "99999.99999 99999.999999 99999.999999 9 99999999999999",
    "documentNumber": "1080001195",
    "conductorNumber": "010800011955",
    "agency": "3391",
    "beneficiaryCode": "7674",
    "amount": "1.00",
    "fine": {
        "date": null,
        "interest": null,
        "value": null
    },
    "discount": {
        "limit": null,
        "value": null,
        "percentage": null
    },
    "expiresAt": "2022-08-04T00:00:00.000Z",
    "updatedAt": "2020-07-08T14:40:34.086Z",
    "createdAt": "2020-07-08T11:38:11.724Z",
    "id": "c5e8b7bf-93b4-4dcd-b156-010a9685173b"
}

Upon confirmation of payment by the custody provider, a deposit-type transaction will be created and recorded on the Stellar blockchain, resulting in the account balance being updated.


Available Providers

The following providers supports Boleto emissions, with its asset codes:

  • Banco BS2: BRLB
  • DOCK (Bradesco): BRLD (deprecated in 2.3.0)

Expiration Date

If, for some reason, the field expiresAt was not send in the payload, the platform will not refuse the generation of Boleto, but it will assume the next business day for the expiration by default.


Limitation amount of a Boleto

A Boleto is limited 30.000,00 Brazilian Reais max daily by default, and should be at least 10 Brazilian Reais.

If it's really necessary to emit a different amount in Boleto, please open a ticket in our Service Desk to request.
All requests will be analyzed by the corresponding Compliance team.


Did this page help you?