O que é token bucket?

Há controle do fluxo de acesso aos serviços do DICT que é realizado por meio de políticas de limitação de requisições gerenciadas pelo BACEN e que utilizam o algoritmo de token bucket.

Em suma, há dois baldes de fichas, um para chaves do tipo EMAIL e PHONE e outro para chaves do tipo CPF, CNPJ e EVP(aleatória) com capacidade máxima de 1000 fichas cada, e há reposição de 2 fichas por minuto até a capacidade máxima do balde de fichas. Caso a quantidade de fichas chegue a zero, haverá limitação de requisições.(*).

Como usar meu balde de fichas?

Regra de contagem da política antiscan:

• Quando há retorno HTTP Status 200 em uma requisição de iniciação de pagamento, subtrai-se 1 ficha;
• Quando é realizada uma confirmação de pagamento, adiciona-se 1 ficha;
• Quando há retorno HTTP Status 404 em uma requisição de confirmação de pagamento para chave inexistente, subtrai-se 20 fichas;

O Banco BS2 disponibiliza um endpoint de validação de Chave DICT, que pode ser utilizado para consultar a validez de uma chave DICT antes de iniciar um fluxo de pagamento, mitigando os retornos HTTP Status 404. Pagamento - Iniciar pagamento por chave .

O Banco BS2 realiza a Validação de Chave DICT automaticamente no fluxo de pagamento assíncrono.

A seguir a documentação do Banco Central sobre o assunto:
https://www.bcb.gov.br/content/estabilidadefinanceira/pix/API-DICT.html#section/Seguranca/Limitacao-de-requisicoes

O que é QR Code Dinâmico?

O QR Code Dinâmico é exclusivo para uma transação específica, e por ser exclusivo, é o mais recomendado para e-commerces, cobranças e compras online.

Este tipo de QR Code permite validar o documento do pagador, pode ser pago apenas uma vez, não tem a possibilidade de alteração do valor por parte do pagador e possui um identificador para conciliação entre Recebimento PIX e Cobrança QR Code.

O que é QR Code Estático?

O QR Code Estático pode ser utilizado em múltiplas transações, não expira e permite que o pagador altere o valor definido no QRCode, se houver.

Este tipo de QR Code é o mais recomendado para transações simples como em transferências de valores sem a necessidade de correlacionar o Recebimento à uma cobrança QR Code.

O que é Identificador de Transação (TxId)?

O Identificador de Transação TxId é o identificador único que permite ao recebedor identificar e correlacionar a transferência, quando recebida, com a cobrança apresentada ao pagador.

O TxId deve ser gerado pelo sistema do parceiro. O parceiro poderá consultar os status de QR Codes e também poderá listar todos os Recebimentos PIX efetivados em conta, via API, utilizando um Identificador de Transação(TxId) como parâmetro.

O que é EndToEndId?

O EndToEndId é um campo de identificação único que o Banco Central do Brasil exige que seja adicionado a todas as transações realizadas por meio do arranjo PIX.

O campo EndToEndId é usado para rastrear uma transação, permitindo que o parceiro e o Banco BS2 realizem verificações de informações sobre uma transação PIX. O EndToEndId é único e é gerado pelo PSP Pagador.

O que é solicitacaoId?

O identificador solicitacaoId é o identificador único de solicitações de Pagamentos Pix (fluxo assíncrono). É possível consultar os status e informações de uma solicitação de pagamento PIX utilizando o atributo solicitacaoId.

O que é pagamentoId?

O identificador pagamentoId é o identificador único para cada pagamento PIX realizado junto ao Banco BS2. É possível consultar os status e informações de uma transação de pagamento PIX via API, definindo o parâmetro pagamentoId.

Pagamento com status confirmado, o que significa?
Alguns pagamentos entram em exceções e permanecem com o status confirmado. Estes, são conciliados automaticamente pelo nosso sistema e em pouco tempo migram para respectivo status final (EFETIVADO ou REJEITADO).

Qual é o limite de QR Codes que podem ser gerados?

Não existe um limite.

Existem limites na quantidade de requisições?

Não existem limites, entretanto, as questões contratuais devem ser respeitadas e caso haja alguma eventualidade, a mesma deverá ser comunicada ao Banco BS2, com antecedência.

Temos limites para Pagamentos?

Existe o limite diário e mensal quanto ao valor transacionado. Por exemplo, se o seu limite for 50 mil, você poderá realizar transações até o limite de 50 mil por dia. Para consultar ou liberar mais limites é necessário enviar uma solicitação de aumento do limite para seu representante comercial.

Não estou recebendo Webhooks

Verifique se o webhook cadastrado está no disponível e com capacidade de receber a notificação em menos de 200ms (este é o tempo máximo para darmos timeout). Caso o erro persista, abra um chamado para a sustentação.

Onde obtenho as credenciais de produção?

O responsável pela liberação e solicitação das credenciais será seu representante comercial. Após a liberação, será possível criar e gerenciar as chaves através do Portal BS2 Empresas, veja em Primeiros Passos.

Qual tipo de autenticação devo utilizar para as APIs do pix?

As APIs de PIX são autenticadas através de um Bearer Token, gerado pela nossa API exclusiva para criação de Tokens

O que é o Certificado X.509 necessário no cadastro Webhook?

Os certificados X. 509 são documentos digitais que representam um usuário, um computador, um serviço ou um dispositivo. Eles são emitidos por uma AC (autoridade de certificação), uma AC subordinada ou uma autoridade de registro e contêm a chave pública da entidade do certificado.