💳 Como os Pagamentos Funcionam

Visão geral de todas as formas de pagamento aceitas no TriviumStore, do dinheiro no balcão ao cartão parcelado: o que muda entre elas e quem confirma cada uma. Para o passo a passo de tela, veja PDV, Loja Virtual e Configurações → Parcelamento.

🔑 Já configurou sua própria conta de gateway?

PIX e cartão de crédito só caem direto na sua própria conta se você cadastrar sua chave (AbacatePay ou Asaas) no sistema. Veja como em Cadastrando sua própria conta (AbacatePay ou Asaas), mais abaixo.

🧾 Resumo por forma de pagamento

Forma	Onde	Quando a venda é confirmada como paga	Parcela?
💵 Dinheiro	PDV / Loja Física	Na hora, junto com o registro da venda	Não
✍️ PIX ou Cartão manual (gateway desligado pra essa loja)	PDV / Loja Física	Na hora, com o operador registrando manualmente	Não (PIX nunca parcela)
⚡ PIX pelo gateway	PDV / Loja Física	Assim que o pagamento cai (o sistema confirma sozinho)	Não
🏧 Cartão via maquininha integrada (TEF)	PDV	Quando a maquininha aprova a transação	Sim, no crédito
📱 Cartão pelo gateway (sem TEF)	PDV	Quando o gateway aprova o checkout (QR code/link)	Sim, no crédito
⚡ PIX	Loja Virtual	Assim que o pagamento cai (o sistema confirma sozinho)	Não
💳 Cartão de Crédito	Loja Virtual	Quando o gateway aprova o pagamento	Sim

📐 Regra geral do parcelamento

Só cartão de crédito parcela. Débito e PIX são sempre à vista, em qualquer canal. E em nenhum caso é a TriviumStore quem financia a compra ou cobra os juros: isso é sempre a adquirente por trás da maquininha (TEF) ou o gateway (AbacatePay/Asaas). O valor que a loja recebe é sempre o total do pedido, de uma vez só.

🛤️ Os três "caminhos" de confirmação

Toda venda passa por uma dessas três formas de confirmar que o dinheiro chegou:

1️⃣ Confirmação imediata

Dinheiro, e PIX/Cartão quando a loja desligou o gateway daquela forma no PDV (veja Configurações → PIX e Cartão no PDV por Loja). O operador já sabe na hora (contou o dinheiro, viu o comprovante recebido por fora) e registra a venda como paga direto. É o caminho mais simples: não existe espera nem checagem depois.

2️⃣ Confirmação pela maquininha (TEF)

Só no PDV, com um terminal configurado com TEF. O sistema conversa com a maquininha através de um agente instalado no computador do caixa; a venda fica "aguardando" até a maquininha aprovar ou recusar o cartão.

👑 O TEF é sempre prioridade

Se o terminal tem TEF ativado, o cartão sempre vai pela maquininha, não importa a configuração de gateway da loja.

3️⃣ Confirmação pelo gateway de pagamento

PIX e Cartão de Crédito/Débito, tanto na loja virtual quanto no PDV (nos terminais sem TEF, e desde que a loja não tenha desligado o gateway daquela forma). O gateway avisa o sistema automaticamente assim que aprova o pagamento; o pedido fica como "aguardando pagamento" até essa confirmação chegar.

No PDV, o cartão pelo gateway mostra um QR Code e um link de checkout hospedado para o cliente pagar pelo próprio celular, já que o PDV não tem um leitor de cartão físico do gateway (só a maquininha TEF tem isso).

⏱️ Por que às vezes demora um pouco pra confirmar

No PIX e no Cartão pelo gateway, o sistema fica checando automaticamente a cada poucos segundos se o pagamento já caiu, não precisa atualizar a tela. Se demorar mais que o normal, tanto no PDV quanto na loja virtual existe um botão para forçar essa checagem na hora. Fechar a tela antes da confirmação não cancela a venda: ela continua pendente e pode ser acompanhada depois em Pedidos.

🔀 Pagamento dividido em mais de uma forma

Uma mesma venda pode ser paga combinando mais de uma forma, por exemplo metade em dinheiro e metade no cartão, ou dinheiro + PIX + cartão de crédito juntos. Disponível em três lugares:

Onde	Formas que podem ser combinadas
PDV	Dinheiro, Cartão de Crédito, Cartão de Débito, PIX e Vale-Compra, em qualquer combinação, incluindo cartão via maquininha integrada (TEF) ou pelo gateway (sem TEF).
Loja Virtual	Só entre PIX e Cartão de Crédito (as únicas formas que existem no checkout online).
Registro manual de venda física (botão Novo Pedido, em Pedidos)	Dinheiro, Cartão de Crédito, Cartão de Débito e Vale-Compra. Sem PIX aqui: esse cadastro é pra registrar uma venda que já aconteceu, sem nenhuma etapa de confirmação de pagamento.

Regras que valem em qualquer um dos três lugares:

• ✅ A soma das partes precisa bater exatamente com o total da venda.
• ✅ No máximo uma parte pode ser PIX por venda.
• ⚠️ No PDV, no máximo uma parte pode depender de confirmação externa por venda: PIX, cartão via maquininha (TEF) e cartão pelo gateway nunca podem se combinar entre si na mesma venda dividida, já que todas esperam uma confirmação de fora (o cliente pagar, a maquininha responder, ou o gateway avisar), e o sistema não encadeia duas esperas na mesma venda hoje.
• ✅ A venda só fica Paga quando todas as partes forem aprovadas. Se uma parte depende de confirmação externa e ainda não confirmou, a venda fica Aguardando Pagamento mesmo com as outras partes já registradas, sem travar o que já foi pago nas demais.
• 🧾 O comprovante e o detalhe do pedido mostram a composição completa, com cada forma e seu valor.
• ↩️ Estornar uma venda dividida (em Estornos ou pelo cancelamento do pedido) reverte todas as partes já aprovadas de uma vez, cada uma pelo seu próprio caminho: não é possível hoje estornar só uma parte e manter o resto da venda.

🔄 O que pode acontecer com um pagamento

Depois de criado, um pagamento só pode seguir por um destes caminhos, nunca "volta atrás" de um estado já fechado:

• Aguardando → aprovado, ou → recusado.
• Aprovado → estornado (se precisar devolver o dinheiro).
• Recusado e Estornado são finais: não é possível reaprovar um pagamento recusado no mesmo registro; se o cliente tentar de novo, nasce um pagamento novo.

↩️ Estorno

Feito na tela de Estornos, a partir do pagamento aprovado. Como o estorno funciona depende de como a venda foi paga:

Forma	O que acontece ao estornar
⚡ PIX	O próprio sistema devolve o valor pela via original, automaticamente.
💳 Cartão de crédito pelo gateway (loja virtual, ou PDV sem TEF)	O sistema pede o estorno direto ao gateway (AbacatePay/Asaas).
🏧 Cartão via maquininha (TEF)	Precisa ser feito fisicamente na maquininha pelo operador primeiro; o sistema só registra o estorno no pedido depois, pra controle. Veja PDV → Estorno de venda paga por TEF.
💵 Dinheiro / ✍️ PIX ou cartão manual	Sem gateway nem maquininha envolvidos: o estorno é só um registro, reverte estoque, financeiro e fidelidade normalmente.

Em todos os casos, ao confirmar um estorno: o estoque volta, a receita é estornada no financeiro, e os pontos de fidelidade daquele pedido são revertidos. Numa venda com pagamento dividido, estornar reverte todas as partes de uma vez, cada uma pelo seu próprio caminho.

🎯 Prefere devolver só parte dos itens?

Estornar cancela a venda inteira. Pra devolver só alguns itens de uma venda física já finalizada, mantendo o resto dela de pé, use a tela de Devoluções em vez desta.

🏦 Cadastrando sua própria conta (AbacatePay ou Asaas)

🚨 Sem isso, o dinheiro das suas vendas online não cai na sua conta

Por padrão, o PIX e o cartão de crédito da sua loja virtual e do PDV passam pela conta padrão do sistema (AbacatePay), a mesma usada por outras lojas que ainda não configuraram a própria. Para o dinheiro das suas vendas cair direto na sua própria conta (e não na conta padrão), é obrigatório:

1. Escolher o provedor, AbacatePay ou Asaas, e criar uma conta lá, se ainda não tiver (abacatepay.com ou asaas.com).
2. Gerar uma chave de API dentro do painel dessa conta.
3. Colar essa chave no TriviumStore, em Configurações → Pagamentos → Gateway de Pagamento.

Sem esse cadastro, sua loja continua vendendo normalmente, mas o dinheiro das vendas PIX/cartão fica na conta padrão do sistema até você configurar a sua.

Em Configurações → Pagamentos, no card Gateway de Pagamento (PIX e Cartão), clique em Configurar para abrir a tela de credenciais e escolha o provedor no topo (AbacatePay ou Asaas).

Campo	Provedor	Obrigatório?	Para que serve
Chave de API	Ambos	Sim	A credencial que conecta sua loja diretamente à sua conta. Gerada dentro do painel da sua conta, em API Keys (ou seção equivalente).
Segredo do webhook	AbacatePay	Recomendado	Uma senha que você mesmo escolhe (qualquer texto). Cadastrada tanto aqui quanto no painel do AbacatePay, garante que só o AbacatePay consegue avisar o sistema que um pagamento foi confirmado; sem isso, a confirmação automática do PIX não funciona pela sua conta, e a loja depende só da checagem manual/periódica.
Chave HMAC customizada (opções avançadas)	AbacatePay	Não	Só preencha se você mesmo configurou uma chave de assinatura própria no painel do AbacatePay. Deixe em branco na grande maioria dos casos.
Token do webhook	Asaas	Recomendado	O token que o Asaas gera pra você ao criar o webhook no painel dele: copie e cole aqui exatamente igual. Garante que só o Asaas consegue avisar o sistema que um pagamento foi confirmado.

Depois de salvar a chave de API (e o segredo/token do webhook), a tela mostra uma URL do webhook única da sua loja, com um botão para copiar. Essa URL precisa ser cadastrada no painel do provedor escolhido (seção de Webhooks), junto com o mesmo segredo/token definido aqui, assim ele sabe para onde avisar quando um pagamento seu for confirmado.

📊 Por que isso importa para o financeiro

Toda a parte de Financeiro do sistema (receita líquida, conciliação, relatórios) parte do princípio de que o dinheiro registrado como recebido realmente entrou. Com a sua própria conta conectada, essa ponta fica sob seu controle total: você acessa direto no painel do provedor o extrato de tudo que entrou, pode conferir contra os pedidos do TriviumStore, e sabe exatamente onde o dinheiro está, em vez de depender de uma conta compartilhada com outras lojas.

Quer voltar a usar a conta padrão do sistema? Clique em Remover na mesma tela: as próximas vendas voltam a usar o gateway padrão, sem afetar vendas já feitas.

🛡️ Segurança contra cobrança duplicada

Duas proteções valem para qualquer forma de pagamento com confirmação externa (PIX ou cartão via gateway/TEF):

• Se a confirmação chegar mais de uma vez (comum em integrações, o gateway pode reenviar o mesmo aviso), o sistema reconhece que já processou aquele pagamento e não aplica o resultado de novo.
• Se o operador clicar em "verificar pagamento" bem na hora em que a confirmação automática também está chegando, o sistema garante que só uma das duas aplica o resultado, nunca as duas ao mesmo tempo.

Isso significa que, na prática, um pedido nunca é marcado como pago em dobro nem tem a fidelidade/financeiro creditados duas vezes pela mesma venda.