Pagamentos

A tela Configurações › Gateways cadastra as credenciais de cada gateway e permite habilitar quantos gateways a loja quiser — cada um com suas formas de pagamento e seu ambiente (sandbox ou produção). No checkout, o cliente escolhe por onde pagar e a forma de pagamento.

Como configurar um gateway

1. Abra Configurações › Gateways e localize o gateway desejado.
2. Preencha as credenciais obrigatórias (marcadas com *). Segredos ficam mascarados depois de salvos e não voltam para a tela — para trocar, digite o novo valor.
3. Marque as formas de pagamento que aquele gateway vai oferecer (PIX, boleto, crédito, débito).
4. Escolha o ambiente: Sandbox (testes) ou Produção.
5. Marque Ativo e clique em Salvar.
6. Copie a URL de webhook mostrada no cartão e cadastre-a no painel do gateway.

Um gateway só é ativado quando as credenciais obrigatórias estão preenchidas. Se algo estiver faltando, o painel informa quais campos faltam.

Gateways disponíveis

Gateway	PIX	Boleto	Cartão	Observação
Manual / Sandbox	✅	✅	✅	Fecha o fluxo sem provedor externo — ideal para homologar a loja
Mercado Pago	✅	✅	✅	Boleto exige endereço de cobrança do cliente
PagBank (PagSeguro)	✅	✅	✅	Notificações podem ser reconsultadas pela API
Pagar.me	✅	✅	✅	API Core v5
Stripe	✅	✅	✅	PIX e boleto dependem da conta Stripe estar habilitada no Brasil
PayPal	—	—	✅	Exige aprovação do comprador; não oferece PIX nem boleto
InfinitePay	✅	—	✅	Checkout hospedado: o cliente é redirecionado e volta para a loja; cartão em até 12x

Homologação

Os gateways externos ainda não foram homologados com credenciais reais. Antes de receber pedidos de verdade, teste cada método em sandbox e confirme o pedido pelo webhook — não apenas pelo retorno da cobrança.

Formas de pagamento

Forma	Como o cliente paga	Confirmação
Cartão de crédito	Dados do cartão, com opção de parcelamento	Em segundos, pelo gateway
Cartão de débito	Dados do cartão	Em segundos, pelo gateway
PIX	QR Code ou “copia e cola”, com prazo de validade	Automática, assim que o banco confirma
Boleto	Linha digitável, com vencimento	Automática após a compensação (pode levar dias úteis)

Os prazos de validade do PIX e do vencimento do boleto dependem do gateway contratado pela sua gráfica.

Regras comerciais (descontos, parcelas e retirada)

O cartão Regras comerciais, no topo da tela, vale para todos os gateways:

Campo	O que faz
Desconto no PIX (%)	Abate a porcentagem do valor cobrado quando o cliente paga por PIX
Desconto no boleto (%)	Idem, para boleto bancário
Parcelas máximas sem juros	Limita o parcelamento oferecido no checkout (1 a 12)
Habilitar pagamento na retirada	Libera a opção Pagar na retirada para pedidos com retirada em balcão

• O desconto é aplicado na cobrança: o pedido mantém o total original e o pagamento guarda o valor efetivamente cobrado, para a conciliação ficar auditável.
• O cliente vê o desconto antes de escolher a forma de pagamento (por exemplo, PIX · R$ 142,50 em um pedido de R$ 150,00 com 5%).
• Pagar na retirada não cobra nada online: o pedido fica Aguardando pagamento e a loja confirma o recebimento no balcão. Só aparece em pedidos de retirada.

Ambientes e segurança

• Sandbox: use as credenciais de teste do gateway. Nada é cobrado de verdade.
• Produção: use as credenciais reais. Nesta condição, o cartão precisa ser tokenizado no front-end — a Grafexa não armazena número de cartão.
• Segredos ficam mascarados (********) e são preservados quando você deixa o campo em branco.
• Toda alteração de gateway é registrada na auditoria, com os segredos redigidos.

Estorno

Administradores podem estornar um pagamento (SUPERADMIN e ADMIN), total ou parcial. O estorno é enviado ao gateway e registrado nos logs de integração. Se o gateway recusar, o status fica como recusado e a mensagem aparece nos logs.

Regras

• Só é possível pagar pedidos no status Aguardando pagamento. Tentar pagar outro pedido mostra “Este pedido não está aguardando pagamento.”
• Se o gateway não aceitar a forma escolhida, aparece “O gateway … não suporta …”.
• Quando o pagamento é confirmado, o pedido vai automaticamente para Análise de arte.
• Toda cobrança e todo aviso do gateway ficam registrados em Logs e auditoria (logs de integração), úteis para conciliação.

O que fazer quando o cliente diz que pagou

1. Procure o pedido pelo número.
2. Verifique o status: se ainda está Aguardando pagamento, consulte o painel do seu gateway.
3. Se o gateway mostra como pago e a Grafexa não, envie ao suporte o número do pedido e o identificador da transação no gateway.