Pular para o conteúdo principal

Perguntas Frequentes

Posso consultar chaves Pix?​

Conforme a Resolução BCB Nº 1, de 12 de agosto de 2020, na Seção II - "Do acesso", existem regras específicas sobre quem pode acessar as informações do Diretório de Identificadores de Contas Transacionais (DICT). Nesta resolução, observa-se que o acesso às informações pode ser obtido pelos participantes diretos e indiretos. O BCB deixa claro quem pode ter acesso ao ambiente, e tudo que não está disposto na normativa não pode ser executado. Portanto, quem não se enquadra como participante direto nem indireto não tem acesso a estas informações.

Como posso identificar a origem dos disparos de webhook?​

Os webhooks são enviados por IPs fixos. Para verificar quais são os IPs de origem utilizados pela plataforma, entre em contato com a instituição. Como método de segurança adicional, recomendamos que você configure um header personalizado no webhook. Veja abaixo um exemplo de configuração:

{
  "uri": "{your_webhook_url}",
  "enabled": true,
  "headers": {
    "headerName": "{your_header_name}"
  }
}

Ao configurar o webhook dessa maneira, sempre que enviarmos um webhook, incluiremos o header configurado por você, permitindo a identificação e autenticação das mensagens.

Configurando Certificado MTLS

O passo a passo ilustrado, com Postman, Insomnia e Bruno, está em Configurando o certificado.

Como gerar minhas credenciais?​

  • Acesse o portal Finance.
  • Abra Desenvolvedor e depois a aba Credenciais.
  • Use Nova credencial para gerar o client_id, o client_secret e o certificado. O passo a passo está em Configurando o certificado.

O Webhook da API de QRCodes não possui status?​

  • A API de QRCodes possui um funcionamento diferente da API de Contas no que se refere aos webhooks. Enquanto a API de Contas utiliza status para acompanhar os eventos, a de QRCodes não trabalha dessa forma. Nesse caso, o webhook retorna apenas um payload com alguns dados do pagador e informações relevantes sobre a cobrança. Assim, o disparo do webhook ocorre somente quando a cobrança é efetivamente paga.
  • Entretanto, é possível contornar cadastrando o webhook de Recebimento da API de Contas. Nesse caso, é importante observar que todos os recebimentos serão notificados via webhook. Para identificar se a notificação corresponde a uma cobrança ou a um recebimento tradicional, basta verificar o parâmetro [txid]: se estiver preenchido com o [txid] da cobrança, significa que o webhook recebido é referente a uma cobrança; se vier como “Null”, trata-se de um recebimento tradicional.