Criar

Criar cobrança Pix com vencimento (PUT Cobv)

PUT /api/v2/cobranca/cobv/{txid} — scope cobv.write. Criação idempotente; o txid vai na URL.

Limitação (Cobv): rotas Cobv exigem cobv.read e cobv.write. Se esses scopes não constarem no token após o login, a API responde 403. Não use cob.read ou cob.write como substituto.

Body (principais campos)

{
  "chave": "e3fe4462-4c8e-42c1-8360-b41b404ae557",
  "nomeRecebedor": "Loja Exemplo LTDA",
  "calendario": {
    "dataDeVencimento": "2026-08-15",
    "validadeAposVencimento": 30
  },
  "valor": {
    "original": "150.00"
  },
  "devedor": {
    "nome": "Maria Pagadora Exemplo",
    "cpf": "11144477735"
  },
  "solicitacaoPagador": "Fatura 123"
}

Campo	Obrigatório	Descrição
`chave`	Sim	Chave Pix do recebedor
`nomeRecebedor`	Sim	Nome do recebedor
`calendario.dataDeVencimento`	Sim	`YYYY-MM-DD`
`calendario.validadeAposVencimento`	Não	Dias úteis após vencimento
`valor.original`	Sim	Valor principal
`devedor`	Sim	Nome + CPF ou CNPJ
`solicitacaoPagador`	Não	Texto exibido ao pagador
`valor.multa`, `juros`, `desconto`	Não	Componentes regulatórios BCB

Exemplo

curl --location --request PUT 'https://api-h.nuvende.com.br/api/v2/cobranca/cobv/SEU_TXID' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --data '{ ... }'

Referência API

Listar

Listar cobranças Pix com vencimento (Cobv)

Consultar

Consultar cobrança Pix com vencimento por txid