Aviso de mudança de cobrança recorrente (Pix Automático), enviado pelo banco

POST

/webhooks/cobr/{contaId}/{token}

curl --request POST \
  --url http://localhost:8080/webhooks/cobr/example/example \
  --header 'Content-Type: application/json' \
  --data '{}'

Chamada pelo banco. A URL usa o mesmo token do aviso de Pix e é registrada por vintem conta webhook quando o banco faz cobrança recorrente. O corpo segue o callback da spec do BCB ({"cobsr": [...]}). Aviso repetido ou fora de ordem não muda nada; cobrança desconhecida é ignorada (RN-42).

Parameters

Path Parameters

contaId

required

string

/^[a-z0-9][a-z0-9-]{0,62}$/

token

required

string

/^[0-9a-f]{48}$/

Request Body^required

Media typeapplication/json

Callback de cobrança recorrente da spec do BCB. Aceito como objeto livre porque quem interpreta é o adapter do banco.

object

Example ^generated

{}

Responses

200

Avisos aplicados.

default

Qualquer outro erro, sempre como Problema. Os mais comuns: 502 quando o banco recusa ou falha (PSPIndisponivel) e 500 para erro interno.

Media typeapplication/problem+json

Erro no formato da spec do BCB (RFC 7807).

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

correlationId

string

violacoes

Array<object>

object

razao

string

propriedade

string

valor

string

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "correlationId": "example",
  "violacoes": [
    {
      "razao": "example",
      "propriedade": "example",
      "valor": "example"
    }
  ]
}