---
title: "Solicitar retentativa de cobrança."
method: POST
path: "/cobr/{txid}/retentativa/{data}"
tags: ["CobR"]
---

# Solicitar retentativa de cobrança.

`POST /cobr/{txid}/retentativa/{data}`

Endpoint para solicitar retentativa de uma cobrança recorrente.

## Response `201`

Cobrança recorrente.

- object — Atributos de cobrança recorrente
  - `idRec` string, required — # Identificador da Recorrência Regra de formação: - RAxxxxxxxxyyyyMMddkkkkkkkkkkk (29 caracteres; "case sensitive", isso é, diferencia letras maiúsculas e minúsculas), sendo: - "R": fixo (1 caractere). "R" para a recorrência criada dentro do Pix; - "A": identificação da possibilidade de novas tentativas, sendo possíveis os valores "R" ou "N" (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 Recorrência, podendo ser: o ISPB do participante direto, o ISPB do participante indireto ou os 8 primeiros caracteres do CNPJ do prestador de serviço de iniciação (8 caracteres alfanuméricos [A-Z|0-9]); - "yyyyMMdd": data (8 caracteres) de criação da recorrência; - "kkkkkkkkkkk": sequencial criado pelo agente que gerou o ID Recorrência (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.”
  - `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
    - `dataDeVencimento` string, date, required — Trata-se de uma data, no formato `YYYY-MM-DD`, segundo ISO 8601. É a data de vencimento da cobrança.
    - `criacao` 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` object, required — Valor da cobrança recorrente
    - `original` string, required — Valor original da cobrança.
  - `ajusteDiaUtil` boolean, required — Campo de ativação do ajuste da data prevista para liquidação para próximo dia útil caso o vencimento corrente seja um dia não útil. O PSP Recebedor deverá considerar os feriados locais com base no código município do usuário pagador.
  - `recebedor` DadosBancariosRecebedor, required
    - `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.
  - `status` 'CRIADA' | 'ATIVA' | 'CONCLUIDA' | 'EXPIRADA' | 'REJEITADA' | 'CANCELADA', required
  - `politicaRetentativa` 'NAO_PERMITE' | 'PERMITE_3R_7D', required
  - `devedor` object — O objeto devedor organiza as informações sobre o devedor da recorrência.
    - `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.
  - `atualizacao` object[], required — Histórico das mudanças de status das cobranças recorrentes.
    - `status` 'CRIADA' | 'ATIVA' | 'CONCLUIDA' | 'EXPIRADA' | 'REJEITADA' | 'CANCELADA', required — Status da cobrança.
    - `data` string, date-time, required — Data e hora do registro de status atualizado. Respeita RFC 3339.
  - `encerramento` union
    - object
      - `cancelamento` object — Informações sobre o cancelamento da cobrança
        - `solicitante` 'PSP_PAGADOR' | 'USUARIO_PAGADOR' | 'PSP_RECEBEDOR' | 'USUARIO_RECEBEDOR', required
        - `codigo` 'ACCT' | 'BLCK' | 'CCLD' | 'FAIL' | 'OTHR' | 'SLBD' | 'SLCR', required — Código do cancelamento. Corresponde ao código de cancelamento presente no catálogo de mensagens.
        - `descricao` string, required — Descricao da causa do cancelamento
    - object
      - `rejeicao` object — Informações sobre a rejeição da cobrança
        - `codigo` 'AB10' | 'AC05' | 'AC06' | 'AM02' | 'AM09' | 'DENC' | 'DS27' | 'DTED' | 'DTNT' | 'FBRD' | 'IRNT' | 'MIDI' | 'MSUC' | 'NIEC' | 'NIPA' | 'NITX' | 'QUNT' | 'RC09' | 'UDEI', required — Código da rejeição. Corresponde ao código de rejeição presente no catálogo de mensagens.
        - `descricao` string, required — Descricao da causa da rejeição
  - `tentativas` object[], required — Histórico de Tentativas de Cobrança
    - `dataLiquidacao` string, date, required — Data prevista para liquidação da cobrança. Trata-se de uma data, no formato `YYYY-MM-DD`, segundo ISO 8601.
    - `tipo` 'AGND' | 'NTAG' | 'RIFL', required — Tipo da tentativa da cobrança.
    - `status` 'SOLICITADA' | 'AGENDADA' | 'PAGA' | 'CANCELADA' | 'REJEITADA' | 'EXPIRADA', required — Status da tentativa da cobrança.
    - `endToEndId` string, required — EndToEndIdentification que transita na PACS002, PACS004 e PACS008
    - `atualizacao` object[], required — Histórico das mudanças de status da tentativa de cobrança.
      - `status` 'SOLICITADA' | 'AGENDADA' | 'PAGA' | 'CANCELADA' | 'REJEITADA' | 'EXPIRADA', required — Status da tentativa da cobrança.
      - `data` string, date-time, required — Data e hora do registro de status atualizado. Respeita RFC 3339.
    - `rejeicao` object — Informações sobre a rejeição da tentativa da cobrança
      - `codigo` 'AB10' | 'AC05' | 'AC06' | 'AM02' | 'AM09' | 'DENC' | 'DS27' | 'DTED' | 'DTNT' | 'FBRD' | 'IRNT' | 'MIDI' | 'MSUC' | 'NIEC' | 'NIPA' | 'NITX' | 'QUNT' | 'RC09' | 'UDEI', required — Código da rejeição da tentativa. Corresponde ao código de rejeição presente no catálogo de mensagens. Os códigos de rejeição da tentativa `AC05`,`AM09`,`DENC`,`DS27`,`DTED`,`MIDI`,`MSUC`,`NITX`,`RC09` e `DTED` causam a rejeição da cobrança recorrente correspondente.
      - `descricao` string, required — Descricao da causa da rejeição

## 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

- **2026-08-19** `5c39d7116745` — 2 info
  - added the optional property `allOf[subschema #2: Cobrança Recorrente Completa]/allOf[subschema #8]/pix/items/allOf[subschema #1: Pix]/componentesValor` to the response with the `201` status
  - removed `#/components/schemas/PixValorOriginal, #/components/schemas/PixValorJuros, #/components/schemas/PixValorMulta, #/components/schemas/PixValorAbatimento, #/components/schemas/PixValorDesconto` from the `allOf[subschema #2: Cobrança Recorrente Completa]/allOf[subschema #8]/pix/items/allOf[subschema #1: Pix]/valor` response property `anyOf` list for the response status `201`
- **2025-06-05** `c1461275c67b` — 2 breaking, 1 info
  - the `allOf[subschema #2: Cobrança Recorrente Completa]/allOf[subschema #10: Histórico de Tentativas da Cobrança Recorrente]/tentativas/items/rejeicao/descricao` response property's maxLength was increased from `105` to `400` for the response status `201`
  - added `subschema #1, subschema #2` to the `allOf[subschema #2: Cobrança Recorrente Completa]/allOf[subschema #9: Histórico de Atualização da Cobrança Recorrente]/encerramento` response property `oneOf` list for the response status `201`
  - removed `subschema #1, subschema #2` from the `allOf[subschema #2: Cobrança Recorrente Completa]/allOf[subschema #9: Histórico de Atualização da Cobrança Recorrente]/encerramento` response property `oneOf` list for the response status `201`
- …earlier changes not shown

[Full history](https://skmtc.dev/bacen/apis/api-pix/changes/cobr/:txid/retentativa/:data/post.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/5c39d7116745/schema)