---
title: "Criar nova cobrança imediata"
method: POST
path: "/pix/v1/collection/immediate"
---

# Criar nova cobrança imediata

`POST /pix/v1/collection/immediate`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/pix/v1/collection/immediate`
- Auth: OAuth 2

Essa API possibilita que seja criada uma cobrança imediata, vinculada a um QR Code já criado (location).

## Request body

- object
  - `clientRequestId` string: Identificador único da transação fornecida pelo do cliente. Este valor não pode ser repetido.
  - `payerQuestion` string: Uma mensagem a ser mostrada ao pagador no momento do pagamento, com no máximo 140 caracteres.
  - `key` string, required: Chave Pix
  - `locationId` integer, required: Identificador do BRCode Location a ser associado a cobrança.
  - `debtor` object: Dados do pagador. Não é permitido que o campo debtor.cpf e campo debtor.cnpj estejam preenchidos ao mesmo tempo. Se o campo debtor.nome está preenchido, então deve existir ou um debtor.cpf ou um campo debtor.cnpj preenchido.
    - `name` string: Nome do Pagador
    - `cpf` string: CPF do Pagador
    - `cnpj` string: CNPJ do Pagador
  - `amount` object, required: Classe de amount para cobranças imediatas
    - `original` number, double, required: Valor da cobrança
    - `changeType` integer: Indicador de possibilidade do pagador editar o valor a ser pago
  - `calendar` object
    - `expiration` integer: Valor em segundos referente ao tempo de validade da cobrança do tipo COB ou COBV.
  - `additionalInformation` object[]
    - `value` string: Valor atrelado a chave como informação adicional a cobrança.
    - `key` string: Chave de referência do valor
  - `change` object

## Response `200`

200

- object
  - `revision` integer
  - `transactionId` integer
  - `clientRequestId` string
  - `status` string
  - `lastUpdate` string
  - `payerQuestion` unknown
  - `additionalInformation` unknown
  - `debtor` object
    - `name` string
    - `cpf` string
    - `cnpj` unknown
  - `amount` object
    - `original` number
    - `changeType` integer
    - `withdrawal` unknown
    - `change` unknown
  - `location` object
    - `merchant` object
      - `postalCode` string
      - `city` string
      - `merchantCategoryCode` string
      - `name` string
    - `url` string
    - `emv` string
    - `type` string
    - `locationId` string
    - `id` unknown
  - `key` string
  - `calendar` object
    - `expiration` integer
  - `createAt` string
  - `transactionIdentification` string

## Other responses

- `400`: 400
- `401`: 401
- `500`: 500

---

[API](https://skmtc.dev/celcoin/apis/api-para-pix-1.md) - [All operations](https://skmtc.dev/celcoin/apis/api-para-pix-1/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-para-pix-1/revisions/02305f8800d4?raw)