Integrações de Pagamento

Para receber online — pelo link de pagamento, pela loja virtual, por um contrato ou pelo Contas a Receber — o sistema precisa de alguém que processe a cobrança de verdade. Esse alguém é uma integração de pagamento: um banco ou um gateway.

Esta página explica quem faz o quê, como escolher e como ligar a integração à forma de pagamento. Para conectar o serviço em si, veja o Hub de Integrações.

Banco ou gateway?

São dois caminhos com consequências diferentes para o seu dinheiro:

Banco — a cobrança é emitida na conta PJ da sua empresa e o dinheiro cai direto nela. Você usa a tarifa que já negociou com o banco. Faz Pix e boleto; não faz cartão.

Gateway — o serviço processa a cobrança, retém a taxa dele e repassa depois, no prazo do contrato. É o caminho para cartão de crédito, parcelamento e antifraude.

Dá para usar os dois ao mesmo tempo, e é o mais comum: o Pix e o boleto pelo banco da empresa, o cartão por um gateway.

Nota

A escolha é por forma de pagamento, não por empresa. Nada impede ter “PIX Banco Inter”, “BOLETO Asaas” e “CARTÃO Pagar.me” convivendo — cada uma apontando para uma integração diferente.

Quem processa o quê

Nem todo serviço faz as três coisas. Antes de conectar, confira se ele cobre o que você precisa:

Bancos

Banco	Pix	Boleto	Cartão
Banco do Brasil	✓	✓	—
Banco Cora	✓	✓	—
Banco Inter	✓	✓	—
Sicoob	✓	✓	—
Sicredi	✓	✓	—

Gateways

Gateway	Pix	Boleto	Cartão
Asaas	✓	✓	✓
BrazilPays	✓	✓	✓
Mercado Pago	✓	✓	✓
Pagar.me	✓	✓	✓
Transfeera	✓	✓	✓
PagHiper	✓	✓	—
EfiPay	✓	—	—
Cielo	—	—	✓
Stripe	—	—	✓

Cuidado

Se a forma de pagamento apontar para um serviço que não processa aquele tipo de cobrança — cartão no Banco Inter, por exemplo —, a cobrança falha na hora de gerar. O sistema não substitui por outro provedor sozinho.

Como o pagamento é processado

1. O cliente abre o link e escolhe como quer pagar.
2. O sistema identifica a forma de pagamento e envia a cobrança para a integração ligada a ela.
3. O banco ou gateway devolve os dados da cobrança — o QR Code do Pix, o boleto ou o resultado da autorização do cartão.
4. Quando o pagamento é confirmado, o provedor avisa o sistema pelo webhook.
5. O pedido recebe a baixa automática, o recebimento é lançado no financeiro e saem as notificações para o cliente.

Ligando a integração à forma de pagamento

Conectar o serviço no hub não basta: é preciso dizer qual forma de pagamento usa qual integração.

1. Conecte o banco ou o gateway no Hub de Integrações.
2. Vá em Vendas → Formas de Pagamento e abra (ou crie) a forma.
3. Na aba Pagamento Online, escolha a integração no campo Integração.
4. Ative Disponível Checkout para ela aparecer para o cliente.
5. Salve.

A partir daí, todo pedido que usar essa forma de pagamento cobra por aquela integração.

Ambiente: produção ou homologação

Ao lado da integração escolhida, o sistema mostra o ambiente dela:

• Produção — as cobranças são reais e movimentam dinheiro de verdade.
• Homologação — ambiente de testes do provedor. As cobranças são fictícias, não movimentam dinheiro, aparecem com o selo Homologação na lista de transações e permitem simular o pagamento para conferir se a baixa automática funciona.

Use homologação para validar o fluxo inteiro antes de abrir para os clientes.

Webhook e baixa automática

O webhook é o aviso que o provedor manda quando o pagamento cai. É ele que dispara a baixa automática.

Na maioria das integrações o sistema cadastra o webhook sozinho, na primeira cobrança emitida por aquela forma de pagamento. O endereço fica gravado no campo URL do webhook, na aba Pagamento Online.

Cuidado

Sem o webhook, a cobrança é gerada e o cliente consegue pagar normalmente — mas o sistema não fica sabendo. O pedido continua em aberto e a baixa precisa ser feita à mão.

Alguns provedores exigem que a URL seja cadastrada por você no painel deles. Quando for o caso, a instrução aparece na janela de conexão da integração.

Conferindo se está tudo certo

Antes de liberar para os clientes, vale rodar este teste:

1. No hub, clique em Verificar status na integração — ele testa as credenciais.
2. Gere uma cobrança de teste em ambiente de homologação.
3. Simule o pagamento no painel do provedor (ou pela transação, quando disponível).
4. Confira em Vendas → Transações se o status mudou e se o pedido recebeu a baixa.

Problemas comuns

A forma de pagamento não aparece no checkout — confira se Disponível Checkout está ativo e se há uma integração selecionada na aba Pagamento Online.

Erro ao gerar a cobrança — quase sempre é credencial inválida, integração pausada ou o provedor não processar aquele tipo de pagamento. Comece por Verificar status no hub.

O cliente pagou mas o pedido continua em aberto — é o webhook. Confira se a URL do webhook está preenchida na forma de pagamento e, se o provedor exigir cadastro manual, se ela foi registrada no painel dele.

A transação aparece com o selo Homologação — a integração está no ambiente de testes. Aquele pagamento não é real.

Veja também

• Hub de Integrações — como conectar cada serviço
• Link de Pagamento — como enviar a cobrança ao cliente
• Integração Banco Cora — passo a passo desse banco
• Cobranças — envio em lote