---
title: "Criar cobrança imediata"
method: POST
path: "/pix/qrcode/collection/immediate"
tags: ["QR Codes Pix"]
---

# Criar cobrança imediata

`POST /pix/qrcode/collection/immediate`

## Request

- Base URL: `https://api.transfeera.com`
- URL: `https://api.transfeera.com/pix/qrcode/collection/immediate`
- Auth: HTTP bearer

## Headers

- `User-Agent` string

## Request body

- object
  - `txid` string: Deve conter entre 26 e 35 caracteres, no formato [A-Za-z0-9]
  - `integration_id` string: ID de integração
  - `location_id` string, uuid: Identificador da location associada ao QR Code. Uma location é para onde a imagem do QR Code (impressa ou exibida) aponta, portanto a mesma imagem impressa pode ser reutilizada em várias cobranças. Ao criar um QR Code: - Se `location_id` for omitido, uma nova location é criada automaticamente e seu `id` é retornado na resposta. - Se `location_id` for informado, a location existente é reutilizada. Para garantir que uma única location esteja sempre associada a no máximo um QR Code por vez, qualquer outro QR Code que esteja previamente vinculado a ela é automaticamente desvinculado.
  - `pix_key` string, required: Chave Pix registrada na Transfeera
  - `original_value` number, required: Valor original
  - `additional_info` object[]: Informações adicionais para o pagador, opcional
    - `key` string, required: Identificador da informação adicional
    - `value` string, required: Valor da informação adicional
  - `payer_question` string: Informação adicional para o pagador
  - `payer` object
    - `name` string, required: Nome do pagador
    - `document` string, required: Número do CPF ou CNPJ do pagador
  - `reject_unknown_payer` boolean: Rejeitar pagamento de desconhecido
  - `expiration` integer: Padrão 86400, tempo de expiração em segundos após criação
  - `value_change_mode` 'VALOR_FIXADO' | 'MODIFICAVEL'
  - `withdraw` object: Campos de Pix saque (entre em contato com suporte para utilizar)
  - `change` object: Campos de Pix troco (entre em contato com suporte para utilizar)
  - `split_payment` PaymentSplit[]: Um ou mais destinatários para pagamento automático
    - `mode` 'FIXADO' | 'PERCENTUAL'
    - `amount` number
    - `destination_bank_account` object
      - `pix_key_type` 'CNPJ' | 'TELEFONE' | 'EMAIL' | 'CHAVE_ALEATORIA' | 'CPF'
      - `pix_key` string
    - `payment_date` string, date: Data para agendamento da execução do split
    - `split_days_after_settled` integer: Número de dias após a liquidação para agendamento da execução do split

## Response `200`

Successful response

- object
  - `id` string
  - `qrcode_type` 'ESTATICO' | 'COBRANCA_IMEDIATA' | 'COBRANCA_COM_VENCIMENTO'
  - `status` 'ATIVA' | 'CONCLUIDA' | 'REMOVIDA_PELO_USUARIO_RECEBEDOR' | 'REMOVIDA_PELO_PSP'
  - `txid` string
  - `integration_id` string
  - `location_id` string, uuid: Identificador da location associada ao QR Code.
  - `pix_key` object
    - `id` string
    - `key` string
    - `key_type` 'CNPJ' | 'TELEFONE' | 'EMAIL' | 'CHAVE_ALEATORIA' | 'CPF'
  - `expiration` integer
  - `original_value` number
  - `value_change_mode` 'MODIFICAVEL' | 'VALOR_FIXADO'
  - `withdraw` object
  - `change` object
  - `payer_question` string
  - `additional_info` object[]
    - `key` string
    - `value` string
  - `payer` object
    - `name` string
    - `document` string
  - `reject_unknown_payer` boolean
  - `emv_payload` string
  - `image_base64` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

---

[API](https://skmtc.dev/transfeera/apis/recebimentos.md) - [All operations](https://skmtc.dev/transfeera/apis/recebimentos/llms.txt) - [OpenAPI document](https://skmtc.dev/transfeera/apis/recebimentos/revisions/4dc648d67cb1?raw)