Atualizar QR Code

Atualiza uma cobranca Pix existente, permitindo alterar valor, expiracao ou descricao.

PATCH/cob/{txid}

Atualiza os dados de uma cobranca Pix existente. Somente os campos enviados serao alterados.

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

Headers

Header	Valor	Descricao
`Content-Type`	application/json	Tipo do conteudo da requisicao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2

Parametros de Rota

Nome	Tipo	Descricao
`txid`	string	Identificador unico da transacao (txid) da cobranca a ser atualizada

Parametros do Body

Nome	Tipo	Obrigatorio	Descricao
`calendario.expiracao`	integer	Opcional	Novo tempo de expiracao em segundos
`devedor.cpf`	string	Opcional	CPF do devedor (11 digitos). Mutuamente exclusivo com cnpj.
`devedor.cnpj`	string	Opcional	CNPJ do devedor (14 digitos). Mutuamente exclusivo com cpf.
`devedor.nome`	string	Opcional	Nome do devedor
`valor.original`	string	Opcional	Novo valor da cobranca em BRL (ex: "25.50")
`status`	string	Opcional	Novo status da cobranca (ex: "REMOVIDA_PELO_USUARIO_RECEBEDOR")
`loc.id`	integer	Opcional	ID do location (payload) a ser vinculado a cobranca
`solicitacaoPagador`	string	Opcional	Nova descricao do pagamento

Exemplo de Request

{
  "calendario": {
    "expiracao": 7200
  },
  "valor": {
    "original": "25.50"
  },
  "solicitacaoPagador": "Pagamento atualizado - Pedido #12345"
}

Exemplo de Response

{
  "calendario": {
    "criacao": "2025-01-15T10: 30: 00.000Z",
    "expiracao": 7200
  },
  "txid": "fc9a43e0b7e14b5a8c3d2f1e0a9b8c7d",
  "revisao": 1,
  "loc": {
    "id": 1234,
    "location": "pix.example.com/qr/v2/abc123def456",
    "tipoCob": "cob"
  },
  "location": "pix.example.com/qr/v2/abc123def456",
  "status": "ATIVA",
  "valor": {
    "original": "25.50"
  },
  "chave": "sua-chave-pix@example.com",
  "solicitacaoPagador": "Pagamento atualizado - Pedido #12345"
}

Exemplos de Codigo

curl -X PATCH https://api.pix.basspago.com.br/cob/{txid} \
  --cert ./client.crt \
  --key ./client.key \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "calendario": {
      "expiracao": 7200
    },
    "valor": {
      "original": "25.50"
    },
    "solicitacaoPagador": "Pagamento atualizado - Pedido #12345"
  }'