---
title: "Criar cobrança"
method: POST
path: "/companies/{companyId}/pix-cash-in/instant-collections"
tags: ["Pix Cobrança"]
---

# Criar cobrança

`POST /companies/{companyId}/pix-cash-in/instant-collections`

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/companies/{companyId}/pix-cash-in/instant-collections`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://id.btgpactual.com/oauth2/token` scopes: `openid empresas.btgpactual.com/pix-cash-in`

## Path parameters

- `companyId` string, required: CNPJ da empresa

## Request body

- PostInstantCollections
  - `pixKey` string, required: Chave pix
  - `locationId` string
  - `expiresIn` number: Tempo para expiração
  - `amount` object, required: Espificações de valor da cobrança
    - `original` number
    - `allowCustomerChangeValue` boolean
  - `displayText` string: Texto de display
  - `payer` PayerPix
    - `name` string: Nome do pagador
    - `taxId` string: CPF/CNPJ do pagador
  - `tags` object: Tag de identificação para a transação

## Response `201`

Location Created

- PostInstantCollectionResponse
  - `id` string
  - `txId` string
  - `taxId` string
  - `status` string
  - `pixKey` string
  - `displayText` string
  - `amount` object
    - `value` number
    - `allowCustomerChangeValue` boolean
  - `emv` string
  - `location` object
    - `id` string
    - `integrationId` string
    - `type` string
    - `path` string
    - `description` string
    - `url` string
    - `integrationUrl` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos.md) - [All operations](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/llms.txt) - [OpenAPI document](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/revisions/2a24d3da114c?raw)
