09. Solução de Problemas

Incompatibilidade de Chaves

O Pix ainda é muito recente e, apenas das padronizações do Banco Central do Brasil, muitos bancos criaram algumas variações e definiram como aceitam determinadas chaves. A recomendação principal é: utilize chaves aleatórias.

As chaves aleatórias seguem o padrão universal uuid, então, não tem o que cada banco inventar aqui. Elas precisam ser aceita no formato v4. Não detectamos qualquer problema de incompatibilidade com esses tipos de chaves.

Algumas chaves que encontramos incompatibilidades para determinados bancos:

• E-mail: alguns bancos aceitam @, outros aceitam espaço e outros aceitam ambos;
• Telefone: alguns bancos aceitam +55, outros ignoram e outros aceitam com e sem +55;
• Transaction ID (tid): alguns bancos não aceitam caracteres diferentes [a-zA-Z0-9], enquanto outros aceitam;

Divergências entre Pix Copia & Cola e QR Codes

Há alguns relatos que alguns bancos leem o QR Code, mas não leem o Pix Copia & Cola. Este não é um problema da biblioteca, o código Pix de ambos são o mesmo! Caso esteja curioso, abra um leitor de QR Code e leia o código é examente o mesmo que o Pix Copia & Cola.

Nesse caso, tente utilizar as funções corretivas como applyEmailWhitespace(), applyValidCharacters() e applyUppercase(). Seu tid será automaticamente corrigido para o formato correto. Alguns bancos podem ter leituras diferentes e, talvez, existam caracteres inválidos para a leitura do Pix Copia & Cola.