---
title: "Criar cobrança"
method: POST
path: "/charges"
tags: ["Cobranças"]
---

# Criar cobrança

`POST /charges`

## Headers

- `User-Agent` string

## Request body

- object
  - `payment_methods` string[], required
  - `payment_method_details` object — Detalhes do método de pagamento
    - `pix` object — Pix do recebedor
      - `pix_key` string — Chave Pix do recebedor
    - `automatic_pix` object — Configurações para Pix Automático Jornada 4, com solicitação de autorização através de QRCode para pagamento com vencimento. A aprovação da autorização será opcional para o pagador e poderá ser feita após o pagamento.
      - `frequency` 'weekly' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual', required
      - `retry_policy` 'not_allowed' | 'allow_three_in_seven_days', required
      - `start_date` string, date, required — Data de início da autorização (YYYY-MM-DD)
      - `end_date` string, date — Data fim da autorização (YYYY-MM-DD)
      - `fixed_amount` integer — - valor em centavos - obrigatório para autorizações com valor fixo
      - `max_amount_floor` integer — - valor em centavos - obrigatório para autorizações com valor variável
      - `identifier` string, required — Identificador da autorização. Pode ser um número de contrato por exemplo.
    - `boleto` object — Configurações de boleto
      - `type` 'other' | 'proposal', required — Tipo de boleto.
  - `payer` object, required — Dados do pagador
    - `name` string — Nome do pagador
    - `trade_name` string — Nome fantasia do pagador
    - `tax_id` string — Número do documento CPF/CNPJ
    - `address` ChargeAddress — Endereço
      - `street` string, required — Logradouro
      - `number` string, required — Número
      - `complement` string — Complemento
      - `district` string, required — Bairro
      - `city` string, required — Cidade
      - `state` string, required — UF
      - `postal_code` string, required — CEP
  - `amount` integer, required — Valor da cobrança
  - `fine_amount` integer — Valor da multa
  - `fine_percent` number, float — Percentual da multa
  - `fine_type` 'fixed' | 'percentage' — Tipo da multa
  - `interest_amount` integer — Valor dos juros
  - `interest_percent` number, float — Percentual dos juros
  - `interest_type` 'fixed_per_day' | 'fixed_per_working_day' | 'percentage_per_month' | 'percentage_per_month_working_days' — Tipo dos juros
  - `discount_amount` integer — Valor do desconto
  - `discount_percent` number, float — Percentual do desconto
  - `discount_dates` object[] — Datas para desconto
    - `amount` integer — Valor do desconto
    - `percent` number, float — Percentual do desconto
    - `date` string, date — Data limite para o desconto
  - `discount_type` 'fixed_until_informed_dates' | 'percentage_until_informed_dates' | 'fixed_per_anticipated_day' | 'fixed_per_anticipated_working_day' | 'percentage_per_anticipated_day' | 'percentage_per_anticipated_working_day' — Tipo do desconto
  - `due_date` string, date-time, required — Data do vencimento
  - `expiration_date` string, date, required — Data de expiração da cobrança
  - `description` string — Descrição
  - `external_id` string — ID externo para integração
  - `split_payment` object[]
    - `mode` 'fixed' | 'percentage', required
    - `amount` integer
    - `amount_percent` number, float
    - `receiver` object, required
      - `pix_key` string, required
    - `payment_date` string, date
    - `split_days_after_settled` integer

## Response `201`

Created response

- ChargeResponse
  - `id` string, uuid — ID da cobrança
  - `payment_methods` string[]
  - `payer` object — Dados do pagador
    - `name` string — Nome do pagador
    - `trade_name` string — Nome fantasia do pagador
    - `tax_id` string — Número do documento CPF/CNPJ
    - `address` ChargeAddress — Endereço
      - `street` string, required — Logradouro
      - `number` string, required — Número
      - `complement` string — Complemento
      - `district` string, required — Bairro
      - `city` string, required — Cidade
      - `state` string, required — UF
      - `postal_code` string, required — CEP
  - `receiver` object — Dados do recebedor
    - `name` string — Nome do recebedor
    - `trade_name` string — Nome fantasia do recebedor
    - `tax_id` string — Número do documento CPF/CNPJ
    - `pix_key` string — Chave Pix
    - `address` ChargeAddress — Endereço
      - `street` string, required — Logradouro
      - `number` string, required — Número
      - `complement` string — Complemento
      - `district` string, required — Bairro
      - `city` string, required — Cidade
      - `state` string, required — UF
      - `postal_code` string, required — CEP
  - `external_id` string — ID externo para integração
  - `receivables` object[] — Recebíveis
    - `id` string, uuid — ID do recebível
    - `status` 'created' | 'processing' | 'paid' | 'refunded' | 'canceling' | 'canceled' — Status
    - `amount` integer — Valor da cobrança
    - `due_date` string, date — Data do vencimento
    - `expiration_date` string, date — Data de expiração da cobrança
    - `fine_amount` integer — Valor da multa
    - `fine_percent` number, float — Percentual da multa
    - `fine_type` 'fixed' | 'percentage' — Tipo da multa
    - `interest_amount` integer — Valor dos juros
    - `interest_percent` number, float — Percentual dos juros
    - `interest_type` 'fixed_per_day' | 'fixed_per_working_day' | 'percentage_per_month' | 'percentage_per_month_working_days' — Tipo dos juros
    - `discount_amount` integer — Valor do desconto
    - `discount_percent` number, float — Percentual do desconto
    - `discount_dates` object[] — Datas para desconto
      - `amount` integer — Valor do desconto
      - `percent` number, float — Percentual do desconto
      - `date` string, date — Data limite para o desconto
    - `discount_type` 'fixed_until_informed_dates' | 'percentage_until_informed_dates' | 'fixed_per_anticipated_day' | 'fixed_per_anticipated_working_day' | 'percentage_per_anticipated_day' | 'percentage_per_anticipated_working_day' — Tipo do desconto
    - `description` string — Descrição
    - `qrcode` object — QR Code
      - `id` string, uuid — ID do QR Code
      - `emv_payload` string — EMV Payload
    - `boleto` object — Boleto
      - `id` string, uuid — ID do boleto
      - `barcode` string — Código de barras
      - `linha_digitavel` string — Linha digitável
      - `identification_number` string — Número de identificação
      - `type` string — Tipo do boleto
    - `automatic_pix` object — Pix Automático
      - `authorization_id` string, uuid — ID da autorização
      - `frequency` string — Frequência da recorrência
      - `retry_policy` string — Política de retentativa
      - `start_date` string, date — Data de início da autorização
      - `end_date` string, date — Data fim da autorização
      - `fixed_amount` string — Valor fixo
      - `max_amount_floor` string — Piso para valor máximo
      - `identifier` string — Identificador da autorização
    - `payments` object[] — Pagamentos
      - `id` string, uuid — ID do pagamento
      - `amount` integer — Valor pago
      - `receipt_url` string — URL do recibo
      - `paid_with` 'boleto' | 'pix' — Método de pagamento
      - `paid_by` object — Dados do pagador
        - `name` string — Nome do pagador
        - `tax_id` string — Número do documento CPF (mascarado)/CNPJ
      - `created_at` string, date-time — Data de criação do pagamento
      - `updated_at` string, date-time — Data de atualização do pagamento
    - `created_at` string, date-time — Data de criação do recebível
    - `updated_at` string, date-time — Data de atualização do recebível
  - `created_at` string, date-time — Data de criação da cobrança
  - `updated_at` string, date-time — Data de atualização da cobrança

---

[API](https://skmtc.net/transfeera/apis/autentica-o.md) · [All operations](https://skmtc.net/transfeera/apis/autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfeera/autentica-o/revisions/cf24b926bbaa/schema)