Pular para o conteúdo principal

Bancos e gateways de pagamento (Marketplace)

Para que serve​

O Marketplace é onde a empresa conecta o próprio banco ou gateway ao Tesselys. As credenciais são da sua empresa: as cobranças saem em seu nome e o dinheiro cai na sua conta. Elas ficam separadas das credenciais da assinatura da plataforma. Uma vez conectado, o provedor pode:

  • Cobrança: emitir boleto, Pix ou cartão para os seus clientes (veja Cobranças).
  • Extrato automático: buscar o extrato no banco sozinho e conciliar o que bater com os títulos (veja Extrato automático).
  • Pagamentos pelo banco: enviar contas a pagar para o banco, para você aprovar no app dele (veja Pagamento automático).

Onde fica​

Sistema › Integrações › Marketplace, na barra lateral. O item aparece quando o plano da empresa tem o recurso de Cobranças (ou o de integrações) e o seu perfil pode ver a configuração de gateway de pagamento.

A tela separa os provedores em Conectados e Disponíveis, com filtro por categoria (Todos, Cobrança, Assinatura, Contabilidade, Agenda, Mídia, Outros) e busca por nome. Os bancos e gateways ficam na categoria Cobrança. Cada card mostra o estado (Conectado, Inativo, Erro, Não conectado ou Em breve), o selo Padrão quando for o caso e as ações no menu ⋮.

Antes de começar​

  • Conta no banco ou gateway com acesso à API liberado. Alguns bancos pedem um contrato de cobrança e a criação de uma "aplicação" no portal de desenvolvedores deles.
  • Credenciais geradas no painel do provedor (chave de API, ou Client ID e Client Secret, conforme o banco).
  • Certificado digital do banco, para Inter, Cora, Sicoob e Itaú, com a senha.
  • Conta bancária cadastrada em Financeiro › Conta Bancária: é a conta onde o dinheiro cai (banco) ou para onde o gateway repassa o saldo. Veja Contas bancárias.
  • Permissão de criar na configuração de gateway de pagamento.

Provedores de cobrança​

ProvedorFormas que emite pelo TesselysOnde o dinheiro caiPede certificado
SicoobBoleto e PixDireto na contaSim (.pfx ou .p12)
InterBoleto e PixDireto na contaSim
ItaúBoletoDireto na contaSim
CoraBoleto e PixDireto na contaSim
EfíBoleto e bolix (boleto com QR Pix)Direto na conta EfíNão
AsaasBoleto, Pix e cartão de créditoSaldo no gateway, depois repasseNão
StripeCartão de créditoSaldo no gateway, depois repasseNão

O catálogo é liberado por empresa. Um provedor marcado Em breve ainda não está habilitado no Tesselys e o card não oferece Conectar. Se você usa um parceiro que não está na lista, fale com o suporte.

Conectando um provedor​

  1. No card do provedor, em Disponíveis, clique em Conectar. Abre a gaveta Configurar Gateway, já com o provedor escolhido e o ambiente indicado num selo.
  2. Em Provedor e Ambiente, dê um Nome da configuração (obrigatório, por exemplo "Asaas - Produção").
  3. Marque os Tipos de cobrança suportados que você quer usar com este provedor (ao menos um). A tela recusa um tipo que o provedor não emite: "Este provedor não emite um dos tipos selecionados."
  4. Em Credenciais, informe os dados que o provedor pede. A tela mostra, para cada provedor, onde encontrar cada dado no painel dele e esconde os campos que ele não usa. Alguns bancos pedem dados do contrato de cobrança:
    • Sicoob: Número do cliente (contrato de cobrança) e Conta corrente.
    • Itaú: agência, conta e dígito; o Código do beneficiário de 12 dígitos é montado sozinho. Opcionais: Carteira (vazio usa 109), Espécie do documento (vazio usa 01) e Nosso número inicial (o último já usado na conta; zero se nunca emitiu por ali; não muda depois de salvo).
    • Efí: Client ID e Client Secret do mesmo ambiente. Opcional: Dias para baixa automática após o vencimento, de 0 a 120 (vazio usa o padrão da conta Efí).
    • Bancos com Pix pedem a Chave PIX recebedora, usada para gerar o QR Code.
  5. Certificado digital (Inter, Cora, Sicoob e Itaú): escolha o formato e anexe o arquivo e a senha. Aceita arquivo único (.pfx ou .p12) ou certificado e chave separados (.crt, .pem ou .cer mais o .key), até 256 KB. O Sicoob aceita só .pfx ou .p12. No formato separado, o arquivo .key é obrigatório.
  6. Em Liquidação & taxas:
    • Banco com liquidação direta: escolha a Conta de recebimento, onde o dinheiro cai (obrigatória).
    • Gateway com saldo próprio (Asaas, Stripe): escolha a Conta de repasse, a conta real para onde o gateway repassa o saldo (obrigatória). O valor bruto fica numa conta transitória criada automaticamente ("Conta Transitória - " e o nome do provedor) até o repasse. Essa conta transitória não pode ser usada como conta de recebimento nem de repasse.
    • Categoria de taxa (opcional): usada na despesa de taxa gerada na baixa. Vazio usa a categoria padrão.
  7. Opcional: Multa e juros deste banco (Multa (%), Juros ao mês (%) e Carência (dias)). Deixe vazio para usar a política da empresa, em Sistema › Configurações › Configurações Gerais › aba Financeiro. Preencha só se os termos negociados com este banco forem diferentes.
  8. Salve. Aparece "Gateway configurado com sucesso".
Segurança das credenciais

As credenciais são guardadas com criptografia e nunca voltam a aparecer em texto aberto. Ao editar, deixe o campo em branco para manter o valor atual. Um certificado já salvo só é trocado se você anexar um arquivo novo.

O certificado tem validade. A configuração mostra até quando ele vale, avisa quando está perto de vencer e quando venceu. Com o certificado vencido, a emissão para até você anexar um novo.

Provedor padrão​

Cada forma de cobrança (boleto, Pix, cartão) tem um provedor padrão, usado quando a cobrança é gerada "via provedor padrão". O primeiro provedor ativo que você conecta já nasce padrão.

  • Use Tornar padrão no menu ⋮ do card. O provedor passa a ser o padrão de todas as formas que ele atende, e o anterior deixa de ser padrão nessas formas.
  • Ao conectar um segundo provedor, o padrão não muda sozinho. A tela avisa qual continua sendo o padrão e oferece trocar.
  • Para ter mais de uma conta no mesmo provedor, use Conectar outra conta no menu ⋮ do card já conectado.

Editar, inativar e reativar​

No menu ⋮ do card conectado:

  • Editar: abre a configuração com as abas descritas abaixo.
  • Inativar: o provedor para de emitir cobranças. Se ele era o único ativo com boleto, os boletos novos passam a nascer parados por falta de provedor (Pix e TED manuais continuam saindo).
  • Reativar (em card inativo): o provedor volta a processar cobranças. Um provedor inativo abre só para consulta, com Visualizar.

Abas do provedor: Extrato, Cobrança e Pagamentos​

Ao editar um provedor conectado, a gaveta tem três abas e abre em Extrato:

AbaO que configuraBancos que oferecem
ExtratoExtrato automático: busca o extrato no banco e concilia o que bater.Cora, Sicoob, Inter, Efí e Asaas
CobrançaCredenciais, tipos de cobrança, contas e taxas (descritos acima).Todos os provedores de cobrança
PagamentosPagamentos pelo banco: envia títulos a pagar para aprovação no app do banco.Cora, Sicoob, Inter e Efí

Cada capacidade aparece como Ligado, Desligado ou Com erro. Para ligar, use Testar e ligar: o banco testa a credencial antes de salvar. Você pode usar a mesma credencial da cobrança (recomendado) ou outra. Ligar os pagamentos pede o aceite do Termo de uso e o código do seu autenticador. Os detalhes de cada capacidade estão em Extrato automático e Pagamento automático.

Regras importantes​

RegraDetalhe
Conta obrigatóriaBanco exige Conta de recebimento; gateway com saldo exige Conta de repasse.
Tipos de cobrançaAo menos um tipo, e só os que o provedor emite.
CertificadoInter, Cora, Sicoob e Itaú exigem certificado válido para emitir. Arquivo de até 256 KB.
AmbienteO ambiente da configuração segue o do sistema. Uma configuração de outro ambiente aparece com o aviso "Esta configuração é de outro ambiente."
CredenciaisNunca são exibidas depois de salvas. Em branco na edição mantém o valor atual.
Provedor inativoSó consulta; não pode ser editado até ser reativado.
Mais de um provedor por formaDefina um padrão, ou as cobranças "via provedor padrão" dessa forma não são geradas.

Permissões​

AçãoPermissão na configuração de gateway de pagamento
Ver o Marketplace e os provedoresLeitura
Conectar e Conectar outra contaCriar
Editar e Tornar padrãoEditar
Inativar e ReativarExcluir

A empresa precisa ter o recurso de Cobranças no plano. Para ligar pagamentos pelo banco, o sistema também pede a confirmação do seu autenticador.

Perguntas frequentes​

Preciso de um gateway para emitir cobranças?​

Para boleto registrado, Pix com QR Code e cartão, sim. Sem provedor, você ainda pode cobrar por Pix ou TED com os dados da conta, ou enviar um boleto emitido por fora (veja Cobranças).

Esqueci a chave de API que cadastrei. Consigo ver?​

Não. A credencial não é exibida depois de salva. Gere uma nova no painel do provedor e substitua na edição.

Apareceu "Certificado digital inválido".​

Confira se o arquivo é .pfx ou .p12 com a chave privada dentro, ou se, no formato separado, você anexou também o .key. Confira também a senha.

Apareceu "Certificado digital vencido".​

Gere um certificado novo no portal do banco, abra Editar no card e anexe o arquivo novo na aba Cobrança. Até lá, a emissão fica parada.

O Itaú recusou o boleto por falta do código do beneficiário.​

Informe agência, conta e dígito na configuração do Itaú. O código do beneficiário tem 12 dígitos: agência (4) + 00 + conta (5) + dígito (1). Ele vem do seu contrato de cobrança com o banco.

Por que o Itaú não oferece Pix?​

O Pix do Itaú é um produto contratado à parte e a credencial de cobrança não traz essa permissão. Por isso o Tesselys emite só boleto pelo Itaú.

Onde vejo as tarifas que o banco cobrou?​

Se o extrato automático estiver ligado com Lançar as tarifas, as tarifas que vierem no extrato viram despesa na categoria escolhida. Taxas informadas pelo gateway na confirmação do pagamento podem virar despesa na Categoria de taxa do provedor.

O que acontece quando inativo um provedor?​

Ele deixa de emitir cobranças novas. Se ele era o único com boleto, os boletos novos nascem parados por falta de provedor até você reativar ou conectar outro.

Ainda com dúvida?

A nossa equipe ajuda você a configurar e usar esse recurso.