Pular para o conteúdo
Acessar sistema

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.

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.

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

BancoPixBoletoCartão
Banco do Brasil✓✓não
Banco Cora✓✓não
Banco Inter✓✓não
C6 Bank✓✓✓ (C6 Pay)
Itaú✓✓não
Sicoob✓✓não
Sicredi✓nãonão
GatewayPixBoletoCartão
Asaas✓✓✓
BrazilPaysnãonão✓
Mercado Pago✓✓✓
Pagar.me✓✓✓
Transfeera✓✓✓
Rede✓✓✓
PagHiper✓✓não
EfiPay✓nãonão
Cielonãonão✓
Stripenãonão✓
InfinitePay✓ (na página dela)não✓ (na página dela)
  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.

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. No menu lateral, clique em Vendas, depois em Pagamentos e em Formas de Pagamento.
  3. Abra (ou crie) a forma de pagamento e vá para a aba Pagamento Online.
  4. Escolha a integração no campo Integração.
  5. Ative Disponível no checkout online para ela aparecer para o cliente.
  6. Salve.

Forma de pagamento PIX com a chave Disponível no checkout online, a aba Pagamento Online, o campo Integração, o quadro Dados da cobrança e a situação do aviso de pagamento numerados de 1 a 5

  1. Disponível no checkout online: faz a forma de pagamento aparecer para o cliente no checkout.
  2. Pagamento Online: a aba que liga a forma de pagamento a uma integração. Ela aparece para cartão, PIX e boleto.
  3. Integração: o banco ou gateway que processa a cobrança. Só aparecem as integrações já conectadas no hub. Abaixo do campo, Conectar nova conta leva ao hub.
  4. Dados da cobrança: como a cobrança aparece para o cliente: Nome na fatura, Nome na tela de checkout e os campos de cada tipo (no PIX, Chave PIX, Validade do QR Code (minutos) e Gerar QR Code na tela de venda; no boleto, Dias de validade do boleto; no cartão, Como o cliente informa o cartão).
  5. Aviso de pagamento: abaixo do campo Integração, diz se o aviso de pagamento do gateway já está ativo. Veja Webhook e baixa automática.

A partir daí, todo pedido que usar essa forma de pagamento cobra por aquela integraçã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.

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 cuida do webhook sozinho, sem nada a configurar: cadastra o endereço no provedor na primeira cobrança emitida por aquela forma de pagamento, ou manda o endereço junto com cada cobrança. Na aba Pagamento Online, abaixo do campo Integração, aparece Aviso de pagamento ativo quando o cadastro no provedor deu certo.

No Stripe, no Pagar.me, na Efí e na Rede o provedor não aceita o cadastro do endereço pelo sistema: a aba Pagamento Online mostra o quadro Webhook de confirmação, com o campo URL do webhook, e a baixa acontece na conferência automática das cobranças pendentes.

No Stripe, depois de cadastrar o endereço em Developers › Webhooks, copie o Signing secret do endpoint (começa com whsec_) e informe na integração do Stripe, no campo Segredo de assinatura do webhook.

No Itaú e no boleto do Banco do Brasil não há webhook: o sistema consulta o banco para saber se a cobrança foi paga. O PIX do Banco do Brasil tem webhook, cadastrado pelo sistema na primeira cobrança. Os intervalos estão em Integração Banco do Brasil e em Integração Itaú.

Na InfinitePay o cliente não paga dentro do checkout: ele é levado à página de pagamento da InfinitePay e escolhe ali entre cartão de crédito (à vista ou parcelado) e Pix.

  1. No Hub de Integrações, conecte a InfinitePay com a Chave da API e a InfiniteTag da conta. A chave é gerada no app ou na Conta Web da InfinitePay, em Configurações > Checkout Integrado, com o checkout integrado ligado. Ela é exibida uma única vez.
  2. Crie a forma de pagamento com o tipo Cartão de crédito, escolha a InfinitePay no campo Integração e, em Como o cliente informa o cartão, escolha Na página do gateway (redirecionamento). Com outro tipo ou com o cartão digitado na tela do sistema, a forma de pagamento não é salva.
  3. Ative Disponível no checkout online. Use no Nome na tela de checkout um texto que avise o cliente que ali dá para pagar com cartão ou Pix, como “Cartão ou Pix (InfinitePay)”.

Regras desse caminho:

  • Validade: cada página de pagamento vale por 1 hora e aceita um único pagamento. Sem pagamento nesse prazo, a transação fica Vencida e o cliente gera outra pelo checkout.
  • Parcelamento: o cliente escolhe na página da InfinitePay, em até 12x. As parcelas configuradas na forma de pagamento não valem ali.
  • Confirmação: a InfinitePay avisa o sistema quando o cliente paga, e o sistema confere o pagamento com ela antes de dar a baixa. Não é preciso cadastrar webhook. O histórico da transação mostra se foi pago com Pix ou com cartão, e em quantas parcelas.
  • Tipo da transação: a transação fica como cartão de crédito mesmo quando o cliente paga com Pix, porque é o tipo da forma de pagamento.
  • Cancelamento e estorno: cancelar uma transação ainda não paga cancela só no sistema, e a página continua aceitando pagamento até expirar. Pagamento já feito não é estornado pelo sistema: o estorno é feito no app ou na Conta Web da InfinitePay.
  • Sem homologação: a InfinitePay não tem ambiente de testes, então toda cobrança é real. Para testar, faça uma compra de valor baixo (o mínimo é R$ 1,00) e estorne pelo app.

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

  1. No hub, clique em Verificar status na integração, que 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 > Pagamentos > Transações se o status mudou e se o pedido recebeu a baixa.

A forma de pagamento não aparece no checkout: confira se Disponível no checkout online 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: sem o aviso de pagamento, a baixa espera a conferência automática das cobranças pendentes (a cada 10 minutos, das 7h às 23h). Confira se a aba Pagamento Online da forma de pagamento mostra Aviso de pagamento ativo.

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