---
title: "Inicialização do Boleto"
method: POST
path: "/brazil/boleto/onetime/external/initialize"
---

# Inicialização do Boleto

`POST /brazil/boleto/onetime/external/initialize`

Endpoint para iniciar uma transação do Boleto.

## Request body

- object
  - `id_invoices` string[], required

## Response `200`

200

- object
  - `transactions` object[] — Boletos gerados (um por fatura, ou combinado).
    - `status` string — Resultado da emissão (ex. success).
    - `id_transaction` string — Identificador da transação na Toku.
    - `nosso_numero` string — Nosso número gerado pelo banco.
    - `barcode` string — Código de barras.
    - `typeable_line_number` string — Linha digitável.
    - `check_digit` string — Dígito verificador (DAC do nosso número).
    - `document_species` string — Espécie do documento (ex. 15).
    - `amount` string — Valor do boleto.
    - `currency` string — Moeda (ex. BRL).
    - `issue_date` string — Data de geração (DD/MM/AAAA).
    - `expiration_date` string — Vencimento (DD/MM/AAAA).
    - `validity_date` string — Data limite de pagamento (DD/MM/AAAA).
    - `barcode_url` string — URL da imagem do código de barras.
    - `qr_url` string — URL do QR (variante boleto-pix).
    - `qr` string — Payload EMV do QR (variante boleto-pix).
    - `beneficiary` object — Dados do cedente.
      - `code` string — Código do beneficiário.
      - `name` string — Nome do cedente.
      - `government_id` string — CPF/CNPJ do cedente.
      - `bank_code` string — Código do banco (ex. 341).
      - `agency` string — Agência.
      - `account_number` string — Conta corrente.
      - `wallet` string — Carteira.
      - `address` object — Endereço do cedente.
        - `street` string
        - `number` string
        - `complement` string
        - `neighborhood` string
        - `city` string
        - `state` string
        - `postal_code` string
    - `payer` object — Dados do sacado (pagador).
      - `name` string
      - `government_id` string — CPF/CNPJ do sacado.
      - `address` object — Endereço do sacado.
        - `street` string
        - `number` string
        - `complement` string
        - `neighborhood` string
        - `city` string
        - `state` string
        - `postal_code` string
    - `id_invoices` string[] — Faturas associadas.

## Other responses

- `400` — 400
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/trytoku/apis/toku-api.md) · [All operations](https://skmtc.net/trytoku/apis/toku-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trytoku/toku-api/versions/30699b13e0d0/schema)