Como integrar pagamento com logo do Pix em vários bancos

Ultima atualizacao: 3 de agosto de 2026

Principais lições deste artigo

• Usar apenas os arquivos oficiais do BCB para a logo do Pix é obrigatório. Redesenhar a marca ou baixar arquivos de fontes aleatórias viola as regras e pode gerar penalidades.
• Para receber em múltiplos bancos, é preciso cadastrar chaves Pix distintas em cada instituição. O DICT não permite a mesma chave em mais de uma conta.
• Gateways como OpenPix, Asaas e Cielo via Braspag oferecem split de Pix e webhooks nativos, o que facilita a conciliação automática entre várias contas.
• Configurar webhooks idempotentes e registrar o EndToEndId de cada transação reduz o risco de duplicidades e aumenta a confiabilidade da conciliação.
• Com o Jota você centraliza todos os recebimentos Pix em um único chat no WhatsApp, sem instalar apps de bancos, incluindo lembretes automáticos de cobranças.

Quando o processo é necessário e pré-requisitos

Integrar Pix com logo oficial em múltiplas contas atende empreendedores que precisam organizar recebimentos em mais de um banco.

• Ter um CNPJ ativo e ao menos duas contas digitais distintas.
• Receber pagamentos em mais de um banco ou filial.
• Precisar de conciliação automática sem conferência manual de extrato.
• Exibir QR Codes ou botões de pagamento em e-commerce, balcão ou links de cobrança.

Antes de começar, vale garantir acesso ao Open Finance para agregar saldos. Também vale considerar abrir uma conta PJ no Jota para ter uma visão consolidada de todas as movimentações.

Passo a passo: 6 etapas para integrar Pix com logo oficial em vários bancos

Passo 1: baixar a logo oficial do bcb e conhecer as regras de uso

Somente os arquivos vetoriais e raster fornecidos pelo Banco Central do Brasil podem ser utilizados. O Manual de Uso da Marca Pix do BCB define regras obrigatórias de aplicação.

• Área de proteção: manter um espaço livre ao redor da marca equivalente à altura do símbolo. Nenhum elemento gráfico pode invadir essa área.
• Cores permitidas: verde oficial do Pix, preto ou branco (versão negativa). Gradientes, sombras e contornos criados pelo usuário são proibidos.
• Fundos escuros ou fotográficos: usar a versão negativa (branca) com sobreposição de ao menos 80% de opacidade.
• Ambientes restritos: em botões de checkout, a versão outline do símbolo é permitida e pode receber a cor dominante da interface, desde que o arquivo oficial do BCB seja utilizado.

Atenção: redesenhar ou recriar a marca Pix é proibido. Use apenas os arquivos disponibilizados pelo BCB.

Passo 2: escolher um gateway compatível com múltiplas contas

Escolher um gateway adequado define como o split e a conciliação vão funcionar na prática. A tabela abaixo compara os principais gateways com suporte a multi-conta e split de Pix.

Gateway	Multi-conta / Split	Webhook nativo	Observação
OpenPix	Sim (SPLIT_PARTNER e SPLIT_SUB_ACCOUNT)	Sim	Split precisa de habilitação pelo suporte. Subcontas exigem chave Pix única.
Asaas	Sim (percentual ou valor fixo)	Sim	Todos os participantes precisam ter conta Asaas. O split não é configurável após a geração da cobrança.
Cielo (Split Braspag)	Sim (split transacional)	Sim	Split apenas no momento da venda. O nome exibido ao pagador é Stelo/Braspag.
Efí (ex-Gerencianet)	Sim	Sim	Participante direto do SPI, com boa documentação para multi-conta.

Ao escolher entre essas opções, vale considerar o perfil da operação e o nível de suporte técnico disponível.

Dica prática: para comércios sem equipe de TI, o OpenPix e o Asaas costumam oferecer interfaces de configuração mais acessíveis. Para marketplaces com volume alto, o Cielo Split via Braspag entrega liquidação em tempo real 24/7 sem intermediários.

Passo 3: cadastrar chaves Pix em cada banco

O DICT (Diretório de Identificadores de Contas Transacionais) do BCB garante unicidade e portabilidade das chaves Pix. Cada chave, seja CPF, CNPJ, e-mail, telefone ou EVP, pode ficar vinculada a apenas uma conta por vez.

Para receber em múltiplos bancos, é preciso cadastrar chaves distintas em cada instituição. Um exemplo é usar o CNPJ em um banco principal e chaves do tipo EVP em bancos secundários.

Erro comum: tentar usar a mesma chave CNPJ em dois bancos ao mesmo tempo. O DICT bloqueia essa configuração. A alternativa é usar chaves do tipo EVP nas contas adicionais.

Passo 4: conectar credenciais via API

A conexão ao SPI exige autenticação mTLS com certificados ICP-Brasil. Em gateways como Asaas ou OpenPix, essa complexidade fica encapsulada.

Nesse modelo, o painel do gateway fornece credenciais como client_id, client_secret ou Bearer Token. O time técnico insere essas credenciais no sistema próprio ou na plataforma de e-commerce.

Incluir um campo de Idempotency-Key (UUID4) em cada requisição de criação de cobrança ajuda a evitar cobranças duplicadas em cenários de retentativa.

Dica prática: usar o campo externalReference no Asaas, ou o equivalente em outros gateways, permite vincular cada transação Pix ao pedido interno e simplifica a conciliação.

Passo 5: configurar webhook para conciliação automática

Endpoints de webhook em sistemas Pix precisam ser idempotentes, pois os provedores garantem entrega pelo menos uma vez. Reenvios por timeout ou retry fazem parte do comportamento esperado.

A configuração recomendada segue três etapas.

1. Registrar o EndToEndId de cada evento recebido antes de aplicar qualquer efeito no sistema.
2. Descartar eventos com EndToEndId já processado.
3. Cruzar periodicamente os registros internos com o extrato do PSP para identificar divergências.

Atenção: a Resolução BCB 538/2025 foi adotada em dezembro de 2025 e publicada em 22 de dezembro de 2025, com prazo de compliance em 1º de março de 2026. Vale confirmar se o gateway já está em conformidade.

Passo 6: testar split de pagamento e exibição da logo

O OpenPix suporta split via API, plataforma e plugin.js. Um payload conceitual para split entre duas contas segue o padrão abaixo.

{ "valor_total": "150.00", "regras_split": [ {"chave_pix": "EVP-conta-principal", "valor": "127.50"}, {"chave_pix": "EVP-conta-secundaria", "valor": "22.50"} ] } 

Após o pagamento, vale conferir três pontos principais. A logo precisa aparecer sem distorção, respeitando o tamanho mínimo de 24 px. O webhook deve retornar status 200 OK. O saldo de cada conta de destino precisa atualizar em tempo quase real após o split.

Critérios de sucesso

A integração funciona bem quando permite rastrear o ciclo completo de cada pagamento Pix, da geração do QR Code até a conciliação.

Esse cenário inclui quatro condições principais.

• O webhook retorna HTTP 200 OK para cada evento de pagamento confirmado.
• A logo do Pix aparece sem distorção, em versão oficial do BCB, com área de proteção preservada.
• O saldo de cada conta de destino atualiza em tempo próximo ao real após o split.
• O EndToEndId de cada transação fica registrado no sistema interno para conciliação posterior.

Variações de uso

A mesma estrutura de integração atende diferentes modelos de negócio.

• E-commerce: QR Code Pix gerado dinamicamente por pedido, com split automático entre loja e fornecedor.
• Vendas presenciais: QR Code fixo no balcão com confirmação instantânea via webhook, como no caso de Raphael Santos, dono de loja de suplementos que usa o Jota para receber confirmações de Pix no WhatsApp sem conferir extrato.
• Cobranças recorrentes: o Jota cria lembretes de cobranças com QR Code Pix prontos para o empreendedor encaminhar ao cliente, sem cobrar taxas diretas. Para boletos recorrentes, o assistente avisa sobre vencimentos e permite agendar pagamentos pelo WhatsApp.

Boas práticas

• Automatizar lembretes: usar o Jota para criar lembretes de cobranças com QR Code Pix pronto, sem taxas diretas, e encaminhar o código ao cliente pelo WhatsApp.
• Revisar extratos consolidados: revisar extratos semanais com o Open Finance do Jota, que consolida movimentações de todos os bancos em um único chat e permite exportar para Excel por banco, tipo de transação e contraparte.
• Organizar conversas: manter conversas arquivadas no WhatsApp para aumentar a segurança. O dinheiro permanece na infraestrutura regulada pelo BCB, não no aplicativo de mensagens.
• Criar rotinas financeiras: usar o recurso de tarefas do Jota para agendar rotinas recorrentes, como conferência de saldo consolidado toda manhã ou lembrete de emissão de nota fiscal.
• Acessar Pix por chat: acessar o Pix via Jota por texto, áudio ou foto, sem precisar abrir apps de bancos.

Perguntas frequentes

Como usar a mesma chave Pix em vários bancos?

Não é possível vincular a mesma chave Pix a mais de uma conta ao mesmo tempo. O DICT do Banco Central garante a unicidade de cada chave. Para receber em múltiplos bancos, a alternativa é cadastrar chaves distintas em cada instituição, como usar o CNPJ em um banco e chaves do tipo EVP nos demais. O Jota, por meio do Open Finance, consolida o saldo de todas essas contas em um único chat no WhatsApp e reduz a necessidade de alternar entre aplicativos.

Como fazer split no Pix?

O split de Pix divide automaticamente o valor recebido entre múltiplas contas no momento da liquidação. Para implementar esse recurso, é preciso usar um gateway que ofereça a funcionalidade, como OpenPix, Asaas ou Cielo via Braspag, e configurar as regras de divisão em percentual ou valor fixo na chamada de API que gera o QR Code. Cada gateway exige que as contas de destino estejam cadastradas na plataforma. O split costuma ser útil para marketplaces, franquias e negócios com múltiplos sócios ou filiais.

Quanto tempo leva a integração?

O tempo de implementação varia conforme o modelo escolhido. Com um gateway como OpenPix ou Asaas e documentação pronta, um desenvolvedor experiente costuma configurar geração de QR Code, webhook e split em um a três dias úteis. O cadastro de chaves Pix em cada banco é imediato. A etapa mais demorada costuma ser a validação de conformidade com as regras de identidade visual do BCB e os testes de idempotência do webhook. Para quem não tem equipe técnica, o Jota oferece uma alternativa sem código, em que basta abrir a conta e conectar os bancos via Open Finance pelo WhatsApp.

É possível integrar sem código?

É possível integrar a gestão de Pix sem escrever código. O Jota é um assistente financeiro com conta digital que opera 100% via WhatsApp, sem necessidade de instalar aplicativos. Por meio do Open Finance, ele conecta múltiplos bancos em um único chat, exibe saldo consolidado, confirma recebimentos de Pix em tempo real e cria lembretes de cobranças com QR Code prontos para envio ao cliente. O onboarding leva de dois a três minutos diretamente pelo WhatsApp. Para quem precisa de split programático em e-commerce, a integração via API de gateways como OpenPix ou Asaas ainda exige desenvolvimento, mas o Jota pode funcionar em paralelo para centralizar a gestão financeira do dia a dia.

Conclusão

Integrar pagamento com logo oficial do Pix em vários bancos envolve seis etapas bem definidas. O processo inclui baixar os arquivos oficiais do BCB e seguir as regras de identidade visual, escolher um gateway com suporte a multi-conta e split, cadastrar chaves Pix distintas em cada banco, conectar credenciais via API com idempotência, configurar webhook para conciliação automática e testar o split junto com a exibição correta da logo.

Para empreendedores que preferem evitar múltiplos apps ou dependência total de uma equipe técnica, o Jota centraliza a operação financeira. O assistente reúne Pix, cobranças, boletos e extrato consolidado de todos os bancos em um único chat no WhatsApp, sem taxas diretas e com rendimento automático do saldo a 100% do CDI.

Centralize sua operação Pix no Jota e concentre todos os recebimentos em um único lugar, sem instalar nenhum app de banco.