Gateway de pagamento
O gateway é o motor por trás da cobrança automática: é ele que emite boleto e PIX, cobra no cartão, avisa quando o dinheiro entra e faz o repasse quando a venda é dividida com um parceiro.
O que é: a integração com o provedor de pagamentos.
O que faz: transforma cada conta a receber em cobrança de verdade, e cada pagamento em baixa
automática.
O provedor e os ambientes
O Sialia foi construído para trabalhar com provedores de pagamento intercambiáveis — a integração é uma peça encaixável, não uma amarração. O provedor disponível hoje é o Safe2Pay.
Sandbox
Ambiente de teste do provedor. Boletos e PIX gerados aqui não cobram ninguém — é onde a implantação valida o fluxo antes de ir ao ar.
Produção
Ambiente real. Toda cobrança gerada aqui é cobrança de verdade, com dinheiro de verdade e cliente de verdade recebendo documento.
Confirme o ambiente antes do primeiro contrato real
Ativar um contrato com o gateway em sandbox gera cobrança que nunca será paga — o cliente não recebe nada e o título fica pendente para sempre. Trocar para produção é a última etapa da implantação, e vale conferir antes de liberar o time comercial.
Configuração das chaves
As credenciais do provedor ficam guardadas de forma mascarada — depois de salvas, ninguém consegue lê-las de volta pela tela.
| Item | Para que serve |
|---|---|
| Chave pública | Identifica a sua conta nas operações que acontecem no navegador do cliente. |
| Chave privada | Autentica as chamadas do servidor. É o segredo mais sensível da integração. |
| Identificador do comerciante | A sua identificação junto ao provedor. |
| Ambiente | Sandbox ou Produção. |
| Moeda | BRL (Real). |
O endereço de retorno não é digitado por você
O endereço que o provedor usa para avisar o Sialia sobre os pagamentos é um parâmetro da plataforma, mantido pelo time que administra o Sialia. Isso evita o erro clássico de cada empresa apontar o retorno para um endereço próprio e os pagamentos deixarem de dar baixa.
Conta bancária e aprovação
Para receber, você precisa de uma conta bancária aprovada junto ao provedor. Essa aprovação é uma verificação de identidade — o provedor precisa saber para quem vai transferir o dinheiro.
Cadastre a conta no Sialia
Banco, agência, conta com dígitos e titular. Marque a integração com o gateway.
A conta entra em análise
A situação fica Pendente e a fila de aprovação aparece no Portal Administrativo.
Aprovação provisiona a conta de repasse
Ao ser aprovada, o sistema cria junto ao provedor a subconta que vai receber os valores daquela empresa. O CNPJ do titular é a identificação usada nessa criação.
Conta liberada para cobrar
Situação Aprovado: os contratos passam a cobrar automaticamente por ela.
O que trava a aprovação
A verificação exige dados completos e coerentes do titular: razão social, endereço completo, cidade e o CPF do responsável preenchidos no cadastro da Empresa, além do documento válido. Falta ou divergência em qualquer um deles é o motivo mais comum de conta rejeitada — e a correção é no cadastro, não no provedor.
Subcontas e split de pagamento
Split é dividir automaticamente o valor de uma cobrança entre mais de um destinatário — você e um parceiro, por exemplo. Cada destinatário precisa da sua subconta de repasse.
flowchart LR
C["Cliente paga
R$ 1.000"] --> G["Provedor
recebe e divide"]
G -->|"85%"| E["Sua conta
R$ 850"]
G -->|"15%"| P["Subconta do parceiro
R$ 150"]
style C fill:#EFF6FF,stroke:#1D4ED8,color:#1E3A8A
style G fill:#F5F3FF,stroke:#7C3AED,color:#4C1D95
style E fill:#ECFDF5,stroke:#047857,color:#064E3B
style P fill:#D1FAE5,stroke:#059669,color:#064E3B
O que a subconta exige
Por que isso importa
Sem split, o repasse ao parceiro é um pagamento manual seu, todo mês, sujeito a atraso e a esquecimento. Com split, a parte dele sai na hora em que o cliente paga — e a comissão registrada no sistema bate com o dinheiro que efetivamente saiu.
Quem paga a taxa
Toda cobrança tem uma taxa do provedor. Existe uma configuração que decide quem absorve esse custo — e ela muda o valor que o cliente vê no boleto.
| Configuração | O que acontece | Efeito no cliente |
|---|---|---|
| A empresa absorve a taxa | O valor cobrado é o do título; a taxa é descontada do que você recebe. | Boleto de R$ 1.000 · você recebe R$ 1.000 menos a taxa. |
| O pagador absorve a taxa | A taxa é somada ao documento. | Boleto sai acima de R$ 1.000 · você recebe o valor integral. |
Confira essa opção com um boleto de teste antes de ir ao ar
Trocar quem paga a taxa altera o valor impresso no documento do cliente. Vale gerar uma cobrança em sandbox e olhar o valor final — é uma conferência de dois minutos que evita explicar diferença de centavos a duzentos clientes depois.
Eventos de retorno (webhooks)
O provedor avisa o Sialia sozinho, sempre que algo acontece com uma cobrança. É esse retorno que dá baixa no título — sem ele você teria que conferir extrato manualmente.
Eventos que o sistema recebe
O que acontece com cada aviso
O evento é registrado
Fica gravado no histórico de eventos, com data e conteúdo.
O título é atualizado
Pagamento recebido dá baixa; falha marca a situação e agenda retentativa.
Você é notificado
Conforme as regras de notificação configuradas.
Aviso que falha não se perde
Se um evento não puder ser processado na hora, ele fica numa fila de reprocessamento em vez de ser descartado. Isso é o que garante que uma indisponibilidade momentânea não deixe um pagamento sem baixa. A fila é visível no Portal Administrativo → Eventos de Retorno.
O fluxo completo
flowchart LR
A["Configurar
chaves e ambiente"] --> B["Cadastrar
conta bancária"]
B --> C{"Aprovação
do provedor"}
C -->|"aprovada"| D["Conta pronta
+ subconta criada"]
C -->|"rejeitada"| E["Corrigir dados
e reenviar"]
E --> B
D --> F["Contrato ativo
gera cobrança"]
F --> G["Cliente recebe
boleto, PIX ou cartão"]
G --> H["Provedor avisa
o Sialia"]
H --> I["Título liquidado ✓
e repasse feito"]
style A fill:#ECFDF5,stroke:#047857,color:#064E3B
style B fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A
style C fill:#F1F5F9,stroke:#94A3B8,color:#475569
style D fill:#D1FAE5,stroke:#059669,color:#064E3B
style E fill:#FEF3C7,stroke:#D97706,color:#78350F
style F fill:#E0F2FE,stroke:#0EA5E9,color:#0C4A6E
style G fill:#FEF3C7,stroke:#D97706,color:#78350F
style H fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A
style I fill:#ECFDF5,stroke:#047857,color:#064E3B
O gateway é o que torna a promessa verificável
“Cobrança automática” só é real quando existe uma integração de verdade emitindo documento e dando baixa. É aqui que o Sialia se separa de um cadastro bonito de contratos.
Repasse na origem
Split divide o pagamento entre você e o parceiro no momento em que o cliente paga. Fim do repasse manual no fim do mês.
Baixa sem conferência
O provedor avisa, o sistema liquida. O financeiro deixa de reconciliar boleto a boleto para saber quem pagou.
Não fica preso a um fornecedor
A integração é encaixável: trocar de provedor é trocar a peça, não reescrever o sistema. Bom argumento contra o medo de dependência.