Skip to main content
POST
Criar uma Cobrança Dinâmica com Vencimento

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

X-Account-Id
string
obrigatório

ID da Conta (formato UUID)

Corpo

application/json
amount
object
obrigatório

Amount é o objeto de configuração de valor (obrigatório)

debtor
object
obrigatório

Debtor é a informação do devedor (obrigatório)

dueDate
string
obrigatório

DueDate é a data de vencimento da cobrança no formato YYYY-MM-DD (ISO8601)

Exemplo:

"2024-12-31"

receiverKey
string
obrigatório

Chave Pix que receberá o pagamento

Exemplo:

"+5511999999999"

txId
string
obrigatório

TxID é o identificador único de transação para esta cobrança

Exemplo:

"TXabcdefghijklmno123456789"

validAfterDue
integer
obrigatório

ValidAfterDue é o número de dias após a data de vencimento em que a cobrança permanece válida

Intervalo obrigatório: x >= 0
Exemplo:

5

additionalInfo
object

AdditionalInfo é um mapa de chave-valor para informações adicionais

Exemplo:
description
string

Description é uma mensagem ou descrição personalizada para a cobrança

Exemplo:

"Pagamento do pedido #12345"

locationInformation
object

LocationInformation contém os dados de localização do estabelecimento para geração do QR code

metadata
object

Metadata é um mapa opcional para pares de chave-valor personalizados (máx. 50 chaves)

tags
string[]

Tags é um array de tags personalizadas para categorização

Exemplo:

Resposta

Created

additionalInfo
object

AdditionalInfo é um mapa de chave-valor para informações adicionais (opcional)

Exemplo:
amount
object

Amount é o objeto de configuração do valor (obrigatório)

createdAt
string

CreatedAt é o timestamp de quando a cobrança foi criada (obrigatório)

Exemplo:

"2024-01-15T10:30:00Z"

debtor
object

Debtor é a informação do devedor (obrigatório)

deletedAt
string

DeletedAt é o timestamp de quando a cobrança foi excluída (opcional, anulável)

Exemplo:

"2024-01-25T10:30:00Z"

description
string

Description é a descrição personalizada da cobrança (opcional)

Exemplo:

"Payment for order #12345"

dueDate
string

DueDate é a data de vencimento da cobrança no formato YYYY-MM-DD (obrigatório)

Exemplo:

"2024-12-31"

emv
string

EMV é o payload do QR code no formato EMV (obrigatório)

Exemplo:

"00020126580014br.gov.bcb.pix..."

id
string

ID é o identificador único da cobrança (obrigatório)

Exemplo:

"550e8400-e29b-41d4-a716-446655440010"

locationUrl
string

LocationURL é a URL para acessar a localização/QR code da cobrança (obrigatório)

Exemplo:

"https://api.example.com/qr/550e8400"

metadata
object

Metadata são os metadados personalizados associados a esta cobrança

receiver
object

Receiver é a informação do recebedor (obrigatório)

receiverKey
string

Chave Pix que receberá o pagamento

Exemplo:

"+5511999999999"

review
integer

Review é o número da revisão da cobrança (obrigatório)

Exemplo:

0

status
string

Status é o status atual da cobrança (obrigatório) Valores válidos: ACTIVE, COMPLETED, REMOVED_BY_RECEIVER, REMOVED_BY_PSP

Exemplo:

"ACTIVE"

tags
string[]

Tags é um array de tags personalizadas (opcional)

Exemplo:
txId
string

TxID é o identificador da transação (obrigatório)

Exemplo:

"TXabcdefghijklmno123456789"

updatedAt
string

UpdatedAt é o timestamp da última atualização (obrigatório)

Exemplo:

"2024-01-20T14:45:00Z"

validAfterDue
integer

ValidAfterDue é o número de dias após a data de vencimento em que a cobrança permanece válida (obrigatório)

Exemplo:

5