Gateways de pagamento
🔒 Plano: requer
online_payments_enabledno plano contratado. 🛂 Permissão:dashboard.view(recomenda-se restringir a admins; envolve credenciais). 📍 Caminho: Configurações → Gateways de Pagamento
A 365 Vendas integra com diversos provedores para receber pagamentos online (PIX, cartão, boleto). Você pode configurar múltiplos gateways, cada um para um método específico, e escolher um como padrão.
Provedores suportados
PIX
- Mercado Pago
- Asaas
- Sicredi PIX
- Itaú PIX
- Banco do Brasil PIX
Cartão (crédito/débito)
- PagSeguro
- Stripe
- Cielo
Multi-método (PIX + cartão + boleto)
- EBANX
Métodos de pagamento
| Método | Código |
|---|---|
| PIX | PIX |
| Cartão de Crédito | CREDIT_CARD |
| Cartão de Débito | DEBIT_CARD |
| Boleto | BOLETO |
| Dinheiro (manual) | CASH |
| Outro | OTHER |
CASH e OTHER não exigem gateway — são pagamentos confirmados manualmente pelo painel.
Como cadastrar um gateway
- Em Configurações → Gateways de Pagamento, clique em Novo Gateway.
- Preencha:
| Campo | Descrição |
|---|---|
| Nome de exibição | Como aparece no checkout (ex.: "PIX Mercado Pago"). |
| Provider | Provedor (Mercado Pago, Asaas, etc.). |
| Método de pagamento | PIX, CREDIT_CARD, etc. |
| Credenciais | Token/chave/segredo do provedor. Os campos variam por provider. |
| Ambiente | Sandbox ou Produção. |
| Webhook secret (alguns providers) | Validação de notificações inbound. |
| Ativo | Habilita/desabilita. |
| Padrão | Marca este gateway como padrão para o método (um padrão por método). |
- Salve.
Credenciais são armazenadas criptografadas. Apenas usuários com permissão de admin podem editar.
Onde obter as credenciais
| Provider | Onde buscar |
|---|---|
| Mercado Pago | Painel ME → Suas integrações → Credenciais (access_token). |
| Asaas | Configurações → Integrações → API Key. |
| Stripe | Dashboard → Developers → API keys (sk_live_...). |
| PagSeguro | Vendas → Minha conta → Token / Email. |
| Cielo | Painel administrativo → Integração API. |
| Itaú / BB / Sicredi PIX | Convênio PIX do banco — solicite ao gerente. |
| EBANX | Dashboard → API → Integration keys. |
Health check (verificar conectividade)
Cada gateway tem um botão de verificação de saúde (ícone de coração) na listagem. Ao clicar, a plataforma faz uma chamada de teste ao provedor:
| Status | Significado |
|---|---|
| Saudável ✅ | Credencial e conectividade OK. |
| Não saudável ⚠️ | Provedor respondeu, mas com erro de configuração. |
| Erro ❌ | Falha de conectividade ou credencial inválida. |
| Não verificado | Ainda não foi testado. |
Use isto após cadastrar e periodicamente — uma credencial revogada faz pedidos falharem em produção.
Definindo o gateway padrão
Marque a flag Padrão em apenas um gateway por método. Quando houver múltiplos PIX cadastrados, o padrão é usado primeiro.
Como o cliente paga
- No checkout, o cliente escolhe o método (PIX, cartão, etc.).
- O sistema usa o gateway padrão daquele método.
- Para PIX: gera QR code + copia-cola.
- Para cartão: tokeniza o cartão diretamente no provedor (a 365 Vendas não armazena PAN).
- O status do pagamento é atualizado via webhook do provedor.
Estados do pagamento
| Status do pedido | Quando acontece |
|---|---|
| Unpaid | Pedido criado, ainda sem pagamento. |
| Waiting_Confirmation | Pagamento iniciado, aguardando confirmação do provedor. |
| Paid | Confirmado. |
A confirmação é automática para gateways online; para CASH/OTHER, o admin marca manualmente em Operações → Pedidos → Confirmar pagamento (permissão order.confirm_payment).
Excluindo um gateway
Não é possível excluir o gateway marcado como padrão — defina outro como padrão antes.
Boas práticas
- Sempre tenha PIX ativo: hoje é o método mais barato e usado no Brasil.
- Mantenha dois provedores PIX se possível (ex.: Mercado Pago + Asaas) — se um cair, o outro absorve.
- Faça health check semanal dos gateways em produção.
- Em ambiente de testes, use o modo Sandbox dos provedores antes de subir para produção.
- Nunca compartilhe credenciais — gere chaves de API dedicadas para a 365 Vendas.