---
title: "Revisar cobrança recorrente."
method: PATCH
path: "/cobr/{txid}"
tags: ["CobR"]
---

# Revisar cobrança recorrente.

`PATCH /cobr/{txid}`

## Request body

- CobRRevisada
  - `status` 'CANCELADA'

## Response `200`

Cobrança recorrente revisada.

- CobRGerada — Atributos de cobrança recorrente
  - `idRec` string, required — # Identificador da Recorrência ID da recorrência: RRxxxxxxxxyyyyMMddkkkkkkkkkkk (29 caracteres; "case sensitive", isso é, diferencia letras maiúsculas e minúsculas), sendo: - "R" ou "C": fixo (1 caractere). "R" caso a recorrência tenha sido criada dentro do Pix, ou "C" caso tenha sido criada pela trilha do Open Finance; - "R" ou "N": fixo (1 caractere). "R" caso a recorrência permita novas tentativas de pagamento pós vencimento, ou "N" caso não permita novas tentativas. - "xxxxxxxx": identificação do agente que presta serviço para o usuário recebedor que gerou o <Id>, podendo ser: o ISPB do participante direto, o ISPB do participante indireto ou os 8 primeiros dígitos do CNPJ do prestador de serviço de iniciação (8 caracteres numéricos [0-9]); - "yyyyMMdd": data (8 caracteres) de criação da recorrência; - "kkkkkkkkkkk": sequencial criado pelo agente que gerou o <Id> (11 caracteres alfanuméricos [a-z|A-Z|0-9]). Deve ser único dentro de cada "yyyyMMdd". Dessa forma, o ID da recorrência deve ser formado de acordo com um dos tipos a seguir: - "RRxxxxxxxxyyyyMMddkkkkkkkkkkk"; para recorrência criada dentro do Pix e que permite novas tentativas de pagamento pós vencimento; ou - "RNxxxxxxxxyyyyMMddkkkkkkkkkkk"; para recorrência criada dentro do Pix e que não permite novas tentativas de pagamento pós vencimento; ou - "CRxxxxxxxxyyyyMMddkkkkkkkkkkk"; para recorrência criada pela trilha do Open Finance e que permite novas tentativas de pagamento pós vencimento; ou - "CNxxxxxxxxyyyyMMddkkkkkkkkkkk"; para recorrência criada pela trilha do Open Finance e que não permite novas tentativas de pagamento pós vencimento.”
  - `txid` string, required — # Identificador da transação O campo `txid` determina o identificador da transação. O objetivo desse campo é ser um elemento que possibilite ao PSP do recebedor apresentar ao usuário recebedor a funcionalidade de conciliação de pagamentos. Na pacs.008, é referenciado como `TransactionIdentification <txId>` ou `idConciliacaoRecebedor`. Em termos de fluxo de funcionamento, o txid é lido pelo aplicativo do PSP do pagador e, depois de confirmado o pagamento, é enviado para o SPI via pacs.008. Uma pacs.008 também é enviada ao PSP do recebedor, contendo, além de todas as informações usuais do pagamento, o txid. Ao perceber um recebimento dotado de txid, o PSP do recebedor está apto a se comunicar com o usuário recebedor, informando que um pagamento específico foi liquidado. O txid é criado exclusivamente pelo usuário recebedor e está sob sua responsabilidade. O txid, no contexto de representação de uma cobrança, é único por CPF/CNPJ do usuário recebedor. Cabe ao PSP recebedor validar essa regra na API Pix.
  - `infoAdicional` string — Informações adicionais da fatura.
  - `calendario` object, required
    - `dataVencimento` string, date, required — Trata-se de uma data, no formato `YYYY-MM-DD`, segundo ISO 8601. É a data de expiração da cobrança.
    - `dataCriacao` string, date, required — Trata-se de uma data, no formato `YYYY-MM-DD`, segundo ISO 8601. É a data de criação da cobrança.
  - `valor` string, required — Valor da cobrança recorrente.
  - `ajusteDiaUtil` boolean, required — Campo de ativação do ajuste da data de vencimento para próximo dia útil caso o vencimento corrente seja um dia não útil. O PSP Pagador deverá considerar os feriados locais com base no código município do usuário pagador.
  - `contaRecebedor` DadosBancariosRecebedor
    - `conta` string, required — Número da conta do usuário recebedor.
    - `tipoConta` 'CORRENTE' | 'POUPANCA' | 'PAGAMENTO', required — Tipo da conta do usuário recebedor.
    - `agencia` string — Número da agência do usuário recebedor.
  - `recebedor` PessoaJuridicaRecorrencia, required
    - `cnpj` string, required — CNPJ do usuário.
    - `nome` string, required — Nome do usuário.
  - `status` 'CRIADA' | 'ATIVA' | 'CONCLUIDA' | 'EXPIRADA' | 'REJEITADA' | 'CANCELADA', required
  - `dadosDevedor` object — O objeto devedor organiza as informações sobre o devedor da cobrança.
    - `email` string — Email do usuário.
    - `logradouro` string — Logradouro do usuário.
    - `cidade` string — Cidade do usuário.
    - `uf` string — UF do usuário.
    - `cep` string — CEP do usuário.

## Other responses

- `400` — Requisição com formato inválido.
- `403` — Requisição de participante autenticado que viola alguma regra de autorização.
- `404` — Recurso solicitado não foi encontrado.
- `503` — Serviço não está disponível no momento. Serviço solicitado pode estar em manutenção ou fora da janela de funcionamento.

## Changes

- **2024-08-30** `e60160879b89` — 1 info
  - endpoint added
- **2020-06-29** `5967a4b6f934` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bacen/apis/api-pix/changes/cobr/:txid/patch.md)

---

[API](https://skmtc.dev/bacen/apis/api-pix.md) · [All operations](https://skmtc.dev/bacen/apis/api-pix/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bacen/api-pix/revisions/e60160879b89/schema)