> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincle.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Issue boleto

> Issues a boleto and returns its viewing URL, barcode, digitable line and due date.



## OpenAPI

````yaml /openapi.yaml post /boleto
openapi: 3.0.3
info:
  title: Fincle API
  version: 1.0.0
  description: >-
    Fincle payments API: charges by Pix, credit card and boleto, subscriptions,
    transactions, refunds, infractions, notifications and transfers.
servers:
  - url: https://api.fincle.com.br
    description: Production server
security: []
tags:
  - name: Authentication
    description: Issuance of the access token from the API key.
  - name: Charges
    description: Creation of charges by Pix, credit card and boleto.
  - name: Subscriptions
    description: Recurring billing on credit card.
  - name: Transactions
    description: Retrieval and refund of transactions.
  - name: Refunds
    description: Refund requests submitted by payers.
  - name: Infractions and MED
    description: Pix infraction reports and the amounts blocked as a result.
  - name: Webhooks
    description: Registration of notification endpoints and tracking of deliveries.
  - name: Balance and transfers
    description: Balance, statement, fees and transfer of the amounts received.
paths:
  /boleto:
    post:
      tags:
        - Charges
      summary: Issue boleto
      description: >-
        Issues a boleto and returns its viewing URL, barcode, digitable line and
        due date.
      operationId: createBoleto
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                postbackUrl:
                  type: string
                  format: uri
                description:
                  type: string
                amountInCents:
                  type: integer
                  exclusiveMinimum: true
                  minimum: 0
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      title:
                        type: string
                      tangible:
                        type: boolean
                      quantity:
                        type: integer
                        minimum: 1
                        maximum: 100000
                      amountInCents:
                        type: integer
                        minimum: 0
                      shippingAddress:
                        type: object
                        properties:
                          street:
                            type: string
                          number:
                            type: string
                          neighborhood:
                            type: string
                          city:
                            type: string
                          state:
                            type: string
                          zipCode:
                            type: string
                        required:
                          - street
                          - number
                          - neighborhood
                          - city
                          - state
                          - zipCode
                        additionalProperties: false
                    required:
                      - title
                      - tangible
                      - quantity
                      - amountInCents
                    additionalProperties: false
                customer:
                  type: object
                  properties:
                    name:
                      type: string
                    email:
                      type: string
                      format: email
                    documentType:
                      type: string
                      enum:
                        - cpf
                        - cnpj
                    document:
                      type: string
                    phone:
                      type: string
                    instagram:
                      type: string
                    billingAddress:
                      type: object
                      properties:
                        street:
                          type: string
                        number:
                          type: string
                        neighborhood:
                          type: string
                        city:
                          type: string
                        state:
                          type: string
                        zipCode:
                          type: string
                      required:
                        - street
                        - number
                        - neighborhood
                        - city
                        - state
                        - zipCode
                      additionalProperties: false
                  required:
                    - documentType
                    - document
                  additionalProperties: false
                seller:
                  type: object
                  properties:
                    name:
                      type: string
                    documentType:
                      type: string
                      enum:
                        - cpf
                        - cnpj
                    document:
                      type: string
                    phone:
                      type: string
                    averageTicket:
                      type: number
                    address:
                      type: object
                      properties:
                        street:
                          type: string
                        number:
                          type: string
                        neighborhood:
                          type: string
                        city:
                          type: string
                        state:
                          type: string
                        zipCode:
                          type: string
                      required:
                        - street
                        - number
                        - neighborhood
                        - city
                        - state
                        - zipCode
                      additionalProperties: false
                  required:
                    - name
                    - documentType
                    - document
                  additionalProperties: false
              required:
                - amountInCents
                - customer
              additionalProperties: false
            example:
              amountInCents: 25000
              description: Invoice no. 2026/001042
              customer:
                name: Helena Martins Andrade
                email: helena.andrade@example.com
                documentType: cpf
                document: '31845792041'
                phone: '11932104567'
                billingAddress:
                  street: Avenida Paulista
                  number: '1374'
                  neighborhood: Bela Vista
                  city: São Paulo
                  state: SP
                  zipCode: '01310100'
      responses:
        '200':
          description: Request processed successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      boleto:
                        type: object
                        properties:
                          url:
                            type: string
                          barcode:
                            type: string
                          digitableLine:
                            type: string
                          dueAt:
                            type: string
                        required:
                          - url
                          - barcode
                          - digitableLine
                          - dueAt
                        additionalProperties: false
                      status:
                        type: string
                      fees:
                        type: number
                    required:
                      - id
                      - boleto
                      - status
                      - fees
                    additionalProperties: false
                required:
                  - success
                  - message
                additionalProperties: false
              example:
                success: true
                message: Transação criada com sucesso
                data:
                  id: cmddiqpxo09zf1yju2kqkhgga
                  boleto:
                    url: https://boleto.example.com/cmddiqpxo09zf1yju2kqkhgga
                    barcode: '34191790010104351004791020150008291070026000'
                    digitableLine: 34191.79001 01043.510047 91020.150008 2 91070026000
                    dueAt: '2026-11-15T00:00:00.000Z'
                  status: pending
                  fees: 349
        '400':
          description: Request rejected due to a validation failure or a business rule.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                required:
                  - success
                  - message
              example:
                success: false
                message: Documento inválido para o tipo selecionado
        '401':
          description: Access token missing, invalid or expired.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                required:
                  - success
                  - message
              example:
                success: false
                message: Não autorizado
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.