---
title: "Inicialização do Pix"
method: POST
path: "/brazil/pix_banking/onetime/external/initialize-transaction"
---

# Inicialização do Pix

`POST /brazil/pix_banking/onetime/external/initialize-transaction`

Endpoint para iniciar uma transação do Boleto.

## Request body

- object
  - `id_invoices` string[], required — Lista de invoices a serem processadas

## Response `200`

200

- object
  - `status` string — Status da cobrança (ex. ATIVA).
  - `id_transaction` string — Identificador da transação na Toku.
  - `txid` string — TXID da cobrança Pix.
  - `pix_key` string — Chave Pix do recebedor.
  - `revision` integer — Revisão da cobrança (revisao).
  - `amount` string — Valor original (valor.original).
  - `expiration_date` string — Vencimento exibido.
  - `copy_paste_code` string — Pix Copia e Cola / payload do QR (até 512 caracteres).
  - `qr_code_url` string — URL da imagem do QR gerada pela Toku.
  - `calendar` object — Calendário da cobrança.
    - `creation` string — Data de criação (criacao).
    - `due_date` string — Data de vencimento (dataDeVencimento).
    - `validity_after_due_days` integer — Dias de validade após o vencimento (validadeAposVencimento).
  - `debtor` object — Devedor.
    - `government_id` string — CPF/CNPJ do devedor.
    - `name` string
  - `receiver` object — Recebedor.
    - `government_id` string — CNPJ/CPF do recebedor.
    - `name` string
    - `trade_name` string — Nome fantasia.
    - `street` string
    - `city` string
    - `state` string
    - `postal_code` string
  - `location` object — Localização do QR (loc).
    - `id` string
    - `location` string — URL do QR no PSP.
    - `cob_type` string — Tipo de cobrança (cob/cobv).
    - `creation` string

## 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)