O que é o número da loja cem no sistema de pagamentos brasileiro
O número da loja cem é um identificador usado em sistemas de pagamento, principalmente no contexto do PIX no Brasil. Quando se fala em número da loja cem, estamos nos referindo ao campo "loja" que aparece em transaçõesPixCoop (PIX entre cooperativas ou instituições financeiras). O valor cem aparece como um identificador padrão em alguns fluxos de integração.
número da loja cem na prática
Na hora de configurar um endpoint de cobrança PIX, o campo loja é um dos que mais causa confusão. A maioria dos dokumentos diz apenas "campo obrigatório" sem explicar o que acontece se você colocar zero, deixar em branco ou enviar um valor que não faz sentido. Acredite, eu já vi gateway quebrar porque o número da loja cem não foi interpretado corretamente pelo sistema do banco. Aqui vai um cenário real que eu enfrentei: estava integrando uma loja virtual com um adquirente novo e o campo loja precisava receber um número entre 1 e 999999, mas a documentação dizia que o valor 100 (cem) era aceito. No homologação funcionava perfeitamente. Na produção, as transações caíam com erro 4004 — campo número da loja cem inválido. O problema? O banco em questão tinha um whitelist interno e só aceitava números de loja que estivessem registrados na conta do vendedor. A solução foi ligar para o suporte do adquirente, solicitar o cadastramento do número 100 na conta e confirmar via portal que o mapping estava correto. Levou cerca de 3 dias úteis. Sem essa verificação, todo pagamento falhava.
O que pouca gente entende sobre o número da loja cem é que ele não é apenas um identificador bonitinho. Ele aparece nos extratos, nos relatórios de conciliação e, se estiver errado, a separação contábil fica comprometida. Um colega meu confundiu dois números de loja no mesmo CNPJ e levou duas semanas para rastrear pagamentos duplicados no relatório mensal. O conserto foi um ajuste manual no sistema financeiro.
Como configurar corretamente o número da loja
A configuração básica segue estes passos: Primeiro, você precisa ter uma conta ativa no adquirente ou na cooperativa financeira. O número da loja cem vai ser vinculado ao CNPJ da empresa. Cada loja física ou canal de venda deve receber um número único. Eu recomendo estabelecer uma convenção de numeração logo no início, senão você acaba com loja 001, loja 1, loja 01 e loja 0001 funcionando como entidades diferentes no mesmo sistema.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Segundo, preencha o campo na hora da chamada de autorização. O formato varia conforme o gateway, mas o padrão mais comum pede um inteiro. Alguns sistemas aceitam string com zeros à esquerda, outros rejeitam. Teste sempre em homologação antes de ir para produção. Terceiro, valide a resposta. Se o gateway retornar um código de autorização positivo mas o número da loja cem não constar no comprovante enviado ao cliente, há um gap de conciliação. Isso não impede o pagamento, mas gera dor de cabeça depois.
Pegadinhas comuns que ninguém conta
O número da loja cem não persiste entre sessões automaticamente em todos os provedores. Se você estiver usando um token de repetição ou um paylink, o campo precisa ser reenviado a cada chamada. Já vi desenvolvedores assumirem que o sistema lembrava do valor e levar horas para entender por que a transação cairia. O workaround é salvar o número da loja em variável de sessão e reconstruir o payload completo a cada requisição. Outro ponto: alguns adquirentes tratam o número 100 como valor reservado ou interno. Se sua integração passar exatamente cem e o pagamento não ir para frente, tente alternativas como 101 ou 200. A diferença costuma ser uma configuração interna do provedor que nunca foi documentada publicamente.
Há ainda o problema da limitação de caracteres. Em integrações mais antigas com API REST, o campo loja às vezes é tratado como VARCHAR 6 e não como INT. Se você enviar 1000000, o sistema simplesmente corta para 000000 e a transação é autorizada com um número de loja errado. A verificação deve ser feita no nível da aplicação, não apenas no gateway.
Conciliação e manutenção
Depois que as transações começam a fluir, o número da loja cem precisa ser monitorado. Configure alertas no seu sistema de conciliação para flagrar divergências entre o número informado na venda e o número registrado no extrato do adquirente. Uma ferramenta simples de cross-check entre o banco de dados dos pedidos e o arquivo de remessa do cartão resolve 90 por cento dos problemas que eu vejo nas empresas. Se o volume for alto, considere automatizar a comunicação com o adquirente via API para atualizações de número de loja. Alterações manuais via portal consomem tempo e, se esquecidas, geram prejuízo direto na reconciliação financeira. Eu uso um script que roda semanalmente e compara os números cadastrados com os números efetivamente usados nas transações dos últimos trinta dias. Diferenças aparecem em menos de dez minutos e o time de financeiro é notificado automaticamente.
O número da loja cem, aparentemente simples, carrega implicações operacionais, contábeis e técnicas. Tratar isso com a atenção devida desde o início economiza horas de trabalho e evita retrabalho que custa dinheiro de verdade.
