Rotas de pagamento
Escolha qual gateway conectado atende Pix, boleto e cartão, para os clientes e para os testes da equipe.
A rota de pagamento diz qual gateway conectado cobra cada forma de pagamento. Com ela, você pode, por exemplo, receber Pix pela Efí e cartão pela Stripe na mesma loja.
Cada forma tem duas rotas, uma por ambiente:
- Clientes · Produção: o gateway que cobra os clientes de verdade.
- Equipe testando · Sandbox: o gateway que a equipe da loja usa para testar a vitrine sem cobrar ninguém.
Testar no Sandbox nunca ocupa o lugar das vendas reais.
Onde configurar
Abra Configurações › Gateways. A seção Checkout, no topo, mostra o que os clientes conseguem pagar e uma linha por forma de pagamento:
| Forma | Clientes · Produção | Equipe testando · Sandbox |
|---|---|---|
| Pix | Os gateways de Produção que aceitam Pix, ou Desativado | Os gateways do Sandbox que aceitam Pix, ou Desativado |
| Cartão | Idem, para cartão | Idem, para cartão |
| Boleto | Idem, para boleto | Idem, para boleto |
Cada troca é salva na hora. A mudança vale para o próximo pedido; pedidos já criados continuam no gateway em que foram cobrados.
A coluna do Sandbox só aparece quando a loja tem um gateway conectado em Sandbox. Cada troca de rota fica registrada nos logs de auditoria.
Regras
- Uma forma sem gateway de Produção não aparece para o cliente. Se nenhuma forma tiver gateway de Produção, a seção mostra Os clientes não veem nenhuma forma de pagamento.
- Cada ambiente só usa conexões dele. A coluna de Produção lista só conexões de Produção, e a do Sandbox, só as do Sandbox.
- Só entram conexões que aceitam aquela forma. Quando nenhuma conexão do ambiente aceita, a célula mostra "Nenhum gateway de Produção aceita" (ou "do Sandbox").
- Ao conectar, o gateway preenche as rotas vazias do ambiente dele. As formas que já tinham rota naquele ambiente continuam como estavam.
- Uma conexão com problema sai do checkout. Se a conexão de uma rota fica como Credenciais inválidas ou Com erro, a forma deixa de aparecer. A célula mostra a conexão marcada como "(com problema)" até você resolver ou escolher outra.
- Desconectar remove a rota. Ao desconectar um gateway, as formas que ele atendia saem do checkout naquele ambiente até você escolher outro.
Exemplo
Uma loja com Efí e Stripe em Produção e a Stripe também em Sandbox:
| Forma | Clientes · Produção | Equipe testando · Sandbox |
|---|---|---|
| Pix | Efí · Produção | Desativado |
| Cartão | Stripe · Produção | Stripe · Sandbox |
| Boleto | Desativado | Desativado |
Os clientes pagam com Pix ou cartão. A equipe testa compras com cartão no Sandbox, sem dinheiro real.
Pedidos pela API
O checkout pela API segue as mesmas rotas. O pedido usa a rota de Produção, a menos que a chamada com a chave secreta envie payment.environment: "sandbox". Uma forma sem rota no ambiente pedido é recusada.
Quem pode alterar
Só o Proprietário e os Administradores da loja. Com a conta de faturamento Restrita por fatura vencida, não é possível alterar rotas nem conectar gateways; os pagamentos continuam funcionando. Veja Fatura vencida.