⌘K

Solicitar Retentativa

Agenda uma nova tentativa de liquidação para uma cobrança recorrente cuja tentativa anterior não foi liquidada (por exemplo, por saldo insuficiente).

A retentativa requer que a recorrência tenha sido criada com politicaRetentativa PERMITE_3R_7D — caso contrário, a API retorna erro 400. São permitidas no máximo 3 retentativas dentro de 7 dias contados a partir da data de vencimento da cobrança.

A API retorna erro 400 se já existir uma tentativa vigente com status SOLICITADA ou AGENDADA para a data informada, ou se a data não for futura.

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

Solicita uma nova tentativa de liquidação para a cobrança na data informada. Requer o scope cobr.write. A requisição não possui body. Retorna 201 com a cobrança completa: a tentativa anterior fica EXPIRADA e uma nova tentativa do tipo NTAG é agendada.

Base URL: https://api.pix.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2 (scope cobr.write)

Parametros de Rota

Nome	Tipo	Descricao
`txid`	string	Identificador da transação (padrão [a-zA-Z0-9]{26,35})
`data`	string	Data futura para a nova tentativa de liquidação (formato YYYY-MM-DD)

Exemplo de Response

{
  "txid": "3136957d93134f2184b369e8f1c0729d",
  "idRec": "RR1234567820260801abcdefghijk",
  "status": "ATIVA",
  "infoAdicional": "Serviço de streaming — ciclo 08/2026",
  "calendario": {
    "criacao": "2026-08-01T10: 30: 00.000Z",
    "dataDeVencimento": "2026-08-15"
  },
  "valor": {
    "original": "35.00"
  },
  "politicaRetentativa": "PERMITE_3R_7D",
  "ajusteDiaUtil": true,
  "recebedor": {
    "agencia": "9708",
    "conta": "012682",
    "tipoConta": "CORRENTE"
  },
  "atualizacao": [
    {
      "data": "2026-08-01T10: 30: 00.000Z",
      "status": "CRIADA"
    },
    {
      "data": "2026-08-05T08: 00: 00.000Z",
      "status": "ATIVA"
    }
  ],
  "tentativas": [
    {
      "dataLiquidacao": "2026-08-15",
      "tipo": "AGND",
      "status": "EXPIRADA",
      "endToEndId": "E12345678202608151221abcdef12345",
      "atualizacao": [
        {
          "data": "2026-08-05T08: 00: 00.000Z",
          "status": "SOLICITADA"
        },
        {
          "data": "2026-08-05T08: 00: 05.000Z",
          "status": "AGENDADA"
        },
        {
          "data": "2026-08-15T09: 00: 00.000Z",
          "status": "EXPIRADA"
        }
      ]
    },
    {
      "dataLiquidacao": "2026-08-18",
      "tipo": "NTAG",
      "status": "AGENDADA",
      "endToEndId": "E12345678202608181010fedcba54321",
      "atualizacao": [
        {
          "data": "2026-08-15T10: 00: 00.000Z",
          "status": "SOLICITADA"
        },
        {
          "data": "2026-08-15T10: 00: 05.000Z",
          "status": "AGENDADA"
        }
      ]
    }
  ]
}

Exemplos de Codigo

curl -X POST https://api.pix.basspago.com.br/cobr/3136957d93134f2184b369e8f1c0729d/retentativa/2026-08-18 \
  --cert ./client.crt \
  --key ./client.key \
  -H "Authorization: Bearer {access_token}"