Pagamento por PIX

Como o sistema recebe e confere os PIX da arena: a chave de cada unidade, o aviso do banco, a confirmação automática da reserva, o que fazer com PIX atrasado, sem cobrança ou contestado (MED), o PIX gerado no balcão e a conferência diária com o extrato do banco.

Nesta página

Recebimento do PIX

RN-PAG-01Conta e chave PIX

A arena recebe todos os PIX numa única conta PJ no Inter. Há uma chave PIX geral da instalação, que cada unidade pode trocar pela chave própria; a partir da segunda unidade ativa, cada unidade precisa ter a sua.

As credenciais e o certificado do banco e a chave geral ficam com a equipe técnica, fora do painel. A chave própria da unidade é cadastrada no campo Chave PIX da unidade. Com uma só unidade, a chave geral basta. Com duas ou mais, é a chave que separa a cobrança e a conferência de cada unidade e diz de qual unidade é um PIX que chegou sem cobrança: se duas unidades ficarem com a chave geral, o sistema não sabe a qual delas pertence esse PIX.

Exemplo A unidade Centro usa a chave centro@arena.com.br e a unidade Norte usa norte@arena.com.br, as duas na mesma conta do Inter. Um PIX de R$ 80,00 que chega na chave da Norte, sem QR, entra como PIX não identificado da unidade Norte.

Quem pode: "Editar unidades, campos, preços, políticas e parâmetros" (Proprietário). Exige 2FA.
Onde se faz: Configuração · Gavetas, parâmetros e taxas · Caixa, PIX e crédito

RN-PAG-02Aviso do banco

Quando um PIX cai, o banco manda um aviso ao sistema. O sistema guarda o aviso, responde ao banco na hora e, antes de lançar qualquer valor, consulta o próprio banco para confirmar o pagamento.

O aviso sozinho nunca confirma nada: vale o que o banco responde na consulta. Se o aviso trouxer dados diferentes da consulta, vale a consulta e o caso fica registrado para a equipe técnica investigar. Os avisos guardados são processados por uma rotina automática a cada 30 segundos.

Exemplo Às 19h03min05s o banco avisa um PIX de R$ 200,00. Em poucos segundos o sistema consulta a cobrança no Inter, vê que ela foi paga e confirma a reserva.

Quem pode: Ninguém: o sistema faz sozinho.
Onde se faz: Rotina automática; o resultado aparece na reserva em Agenda · Recebimento

RN-PAG-03Confirmação da reserva

A reserva em hold é confirmada quando a soma dos PIX recebidos atinge o exigido pela regra que o cliente aceitou: o valor integral ou o sinal. O recibo sai pelo WhatsApp logo em seguida.

Confirmada a reserva por qualquer caminho (QR do hold, PIX não identificado vinculado ou decisão da equipe na fila), os QR do hold que ainda estavam em aberto são cancelados no banco, para não serem pagos de novo. Se mesmo assim entrar outro PIX, o valor vira crédito do cliente (veja Situações especiais).

Exemplo Jogo de R$ 200,00 com sinal de 50%. O cliente paga o QR de R$ 100,00: a reserva fica Confirmada com garantia Sinal, o cliente recebe "Reserva confirmada" e os R$ 100,00 restantes ficam como saldo a pagar na arena.

Quem pode: Ninguém: o sistema faz sozinho.
Onde se faz: WhatsApp · Pagar o PIX; saldo na reserva em Agenda · Recebimento

RN-PAG-04Conferência automática a cada minuto

A cada minuto, o sistema pergunta ao banco por todas as cobranças PIX ainda pendentes criadas nas últimas 48 horas. O pagamento que ele encontrar segue o mesmo caminho do aviso do banco, sem risco de ser lançado duas vezes.

É o que garante a reserva quando o aviso do banco se perde. Também é o que confirma sozinho um hold em verificação ("Cliente diz que pagou") assim que o PIX aparece.

Exemplo O cliente paga às 20h04, mas o aviso do banco não chega. Às 20h05 a conferência encontra a cobrança paga e confirma a reserva.

Quem pode: Ninguém: o sistema faz sozinho, a cada 60 segundos.
Onde se faz: Rotina automática

RN-PAG-05Pagamento atrasado

Um PIX que chega depois de o hold ter vencido (ou depois de o hold ter sido trocado, desistido pelo cliente ou derrubado pela equipe) confirma a reserva sozinho se o horário ainda estiver livre, com a política que o cliente aceitou. Se o horário já estiver ocupado, o valor fica guardado como pagamento do cliente e entra na fila "PIX tardio com horário ocupado".

No conflito, o cliente recebe na hora a mensagem "PIX tardio em análise", dizendo que um atendente vai entrar em contato. Sai uma mensagem por reserva.
Na fila, a equipe resolve com Remarcar, Conceder crédito ou Devolver. A devolução acima da alçada de quem decide vai para aprovação.
Vale também para o hold cancelado por falha do banco ou por bloqueio do horário.

Exemplo O hold das 21h venceu às 17h15 e o cliente pagou R$ 200,00 às 17h40. Caso 1: o horário continua livre, a reserva volta a Confirmada e o cliente recebe o recibo. Caso 2: às 17h30 a recepção já tinha reservado o horário para outro time no balcão; os R$ 200,00 ficam guardados, o cliente recebe "PIX tardio em análise" e a recepção oferece remarcar para as 22h.

Quem pode: A confirmação é automática. O conflito é tratado por quem tem "Tratar itens da fila de tratativas" (Operador, Gerente, Proprietário); devolver acima da alçada pede "Aprovar devolução (até a alçada)" (alçada de fábrica: Operador R$ 0, Gerente R$ 300, Proprietário sem limite).
Onde se faz: Tratativas · Fila

RN-PAG-06Pagador diferente do cliente

O PIX pode ser pago por outra pessoa ou empresa que não o cliente da reserva; o CPF ou CNPJ de quem pagou fica registrado. Devolução por PIX sempre volta para a conta que pagou.

Exemplo A reserva é do João, mas quem paga o PIX de R$ 200,00 é a esposa dele. A reserva confirma normalmente. Se depois houver devolução por PIX de R$ 100,00, o dinheiro volta para a conta da esposa, não para a do João.

Quem pode: Ninguém: o registro é automático. A devolução é feita por quem tem "Tratar itens da fila de tratativas" ou "Solicitar devolução" (Operador, Gerente, Proprietário), dentro da alçada.
Onde se faz: Tratativas · Fila · Devolver

RN-PAG-07PIX sem cobrança (não identificado)

Um PIX que chega sem QR do sistema (por exemplo, pago direto na chave) entra como "não identificado". Se houver exatamente uma reserva, fatura ou comanda pendente do mesmo CPF de quem pagou e com o mesmo valor, o sistema vincula sozinho; senão, abre na fila um "PIX não identificado".

A unidade do PIX é a da chave que o recebeu (RN-PAG-01).
O vínculo automático fica registrado na auditoria.
Na fila, a equipe resolve com Vincular pagamento (a uma reserva, fatura ou comanda) ou Devolver para quem pagou.

Exemplo Chega na chave da unidade um PIX de R$ 200,00 do CPF da Maria, que tem um hold de R$ 200,00 aberto. O sistema vincula e confirma a reserva. Outro PIX de R$ 150,00 chega de um CPF sem nada pendente: entra na fila como PIX não identificado, e a recepção, depois de falar com o cliente, vincula à comanda dele.

Quem pode: "Tratar itens da fila de tratativas" (Operador, Gerente, Proprietário); devolver acima da alçada pede aprovação.
Onde se faz: Tratativas · Fila

RN-PAG-08PIX no balcão

No balcão, o PIX é sempre um QR gerado no painel e ligado à reserva, fatura ou comanda que está sendo paga. A chave PIX da arena não é divulgada.

Assim o pagamento entra sozinho no documento certo, sem virar PIX não identificado. O QR do balcão vale 30 minutos, de fábrica. Na reserva, o botão é Gerar PIX do saldo; quando o banco confirma, aparece "Pagamento PIX confirmado.".

Exemplo O time chega às 19h40 para o jogo das 20h com R$ 100,00 de saldo. A recepção abre a reserva, clica em Gerar PIX do saldo e mostra o QR de R$ 100,00 ao cliente. O cliente paga às 19h42, o saldo zera e o check-in fica liberado.

Atenção Não passe a chave PIX da arena ao cliente, nem por escrito. O PIX feito direto na chave não fica ligado a nenhuma reserva e cai na fila como não identificado.

Quem pode: "Abrir, operar e fechar o próprio caixa" (Operador, Gerente, Proprietário).
Onde se faz: Agenda · Recebimento

Situações especiais do PIX

O que o sistema faz quando o pagamento chega repetido, atrasado, fora de ordem ou com valor diferente do esperado (PRD, seção 6.3).

Situação	O que acontece
O banco avisa o mesmo PIX duas vezes	O PIX é lançado uma vez só; o aviso repetido é ignorado. Antes de ignorar, o sistema confere se a repetição bate com o que o banco confirmou.
Chega aviso de um PIX sem cobrança do sistema	Vira PIX não identificado (RN-PAG-07).
O aviso do banco traz dados diferentes da consulta ao banco	Vale a consulta ao banco. O aviso divergente fica guardado, com a origem, para a equipe técnica investigar.
Pago o PIX de um hold que o cliente trocou	Mesmo tratamento do pagamento atrasado (RN-PAG-05) sobre o horário original.
Pago o PIX de uma reserva remarcada ou suspensa	O valor vai para a reserva que substituiu a original. Se não houver, entra na fila "PIX tardio com horário ocupado" e o cliente recebe "PIX tardio em análise".
PIX acima do valor exigido	A reserva confirma. O que sobra abate o saldo da reserva ou, sem saldo, vira crédito do cliente (válido por 90 dias, de fábrica). Na comanda avulsa sem responsável não há a quem dar crédito: a sobra fica como PIX não identificado, na fila, para devolver a quem pagou ou vincular.
PIX abaixo do valor exigido	A reserva não confirma. O valor recebido fica registrado e abre na fila "Cliente diz que pagou", para a equipe decidir.
Mensagem de WhatsApp repetida	É ignorada; o bot responde uma vez só.
Clique duplo num botão do painel	A ação é feita uma vez só.
Duas pessoas editando o mesmo registro no painel	A segunda a salvar recebe aviso de conflito e recarrega a tela antes de tentar de novo.

Contestação e conferência com o banco

RN-FIN-07MED (contestação do PIX)

Quando o banco aceita a contestação de um PIX (MED), a equipe registra o MED no painel: o valor estornado volta a ser devido na reserva, fatura ou comanda, o proprietário é alertado e o cliente vai para a sugestão de lista negra.

O MED é analisado no Internet Banking do Inter. No sistema, quem registra localiza o PIX pelo endToEndId do PIX contestado (está no aviso do MED no banco) e informa o Valor do MED e o Motivo.
O valor vai até o que aquele PIX pagou no documento, menos o que já foi devolvido (ou está em devolução) e o MED já registrado. A tela mostra esse limite em Cabe de MED. O que do PIX virou crédito na carteira do cliente não entra.
Ao registrar, o saldo devedor do documento reabre e segue as cobranças normais. Abrem na fila o pedido "MED (contestação do PIX)" (prioridade Alta) e a "Sugestão de lista negra", em que alguém decide se inclui o cliente. O proprietário recebe WhatsApp no número de alerta, se preenchido.
Na DRE, o MED entra como dedução da receita, sem linha própria de perda.
PIX não identificado (sem documento) não aceita MED: ele é resolvido pela devolução no pedido "PIX não identificado".

Exemplo Um cliente pagou R$ 200,00 por PIX numa reserva e já recebeu R$ 50,00 de devolução. Dias depois, o Inter avisa um MED desse PIX. A gerente abre Registrar MED, cola o endToEndId e vê "Cabe de MED: R$ 150,00". Ela registra R$ 150,00: a reserva volta a ter R$ 150,00 de saldo devedor e a fila ganha o pedido de MED e a sugestão de lista negra.

Quem pode: "Aprovar devolução (até a alçada)" (Gerente, Proprietário). Exige 2FA.
Onde se faz: Tratativas · Fila · Registrar MED

RN-FIN-15Conciliação bancária diária

Todo dia às 6h, o sistema compara a lista de PIX recebidos no banco no dia anterior com os PIX que ele registrou. Cada diferença, em qualquer direção, abre na fila uma "Divergência na conciliação".

A comparação é feita PIX a PIX pelo identificador do banco (endToEndId). Se a lista do banco não puder ser lida, a equipe importa o arquivo OFX do extrato em Importar OFX, na tela Conciliação bancária. Uma linha do OFX sem identificador casa pelo valor e pelo dia com um único PIX ainda não conciliado da unidade; sem par único, vira divergência.
Tipos de divergência na tela: Só no banco (crédito no extrato sem PIX no sistema), Só no sistema (PIX registrado que o extrato não traz) e Valor diferente.
O PIX que estava só no banco (o aviso e a conferência automática perderam) é lançado na hora pelo caminho normal: pode confirmar a reserva, quitar a fatura ou virar PIX não identificado. A divergência fica aberta para investigar a falha.
Na fila, a divergência se resolve com Lançar ajuste (um lançamento com motivo num documento indicado, aumentando ou reduzindo o devido) ou Registrar investigação (encerra sem mexer em valores). O vínculo de um PIX que virou não identificado é feito no pedido "PIX não identificado" dele, não na divergência.
Débitos do extrato (devoluções, tarifas) aparecem na tela, mas ainda não são conciliados.

Exemplo Às 6h de terça, a conferência de segunda encontra no banco um PIX de R$ 120,00 das 21h37 que o sistema não tinha. O sistema lança esse PIX, que confirma uma reserva que tinha expirado com o horário ainda livre, e abre a divergência "Só no banco". O gerente vê que o aviso do banco falhou naquela noite e encerra com Registrar investigação.

Quem pode: A conferência é automática. Ver a tela e importar OFX: "Ver DRE, fluxo de caixa e conciliação" (Gerente, Proprietário). Lançar ajuste: "Lançar ajuste no ledger para resolver divergência da conciliação" (Gerente, Proprietário), que basta também para listar as reservas do dia e as faturas no quadro do ajuste, sem "Ver agenda e grade". Registrar investigação: "Tratar itens da fila de tratativas" (Operador, Gerente, Proprietário). As duas primeiras exigem 2FA.
Onde se faz: Rotina automática, todo dia às 6h (horário de Brasília); tela em Conciliação bancária; divergência em Tratativas · Fila

Parâmetros deste módulo

"Parâmetros da unidade" fica em Configuração, aba Gavetas, parâmetros e taxas, e só quem tem "Editar unidades, campos, preços, políticas e parâmetros" (Proprietário) altera.

Parâmetro	Valor de fábrica	Onde se altera	Regra
Chave PIX da unidade	Vazio (vale a chave geral; obrigatória a partir da segunda unidade ativa)	Parâmetros da unidade · Caixa, PIX e crédito	RN-PAG-01, RN-PAG-07
Regra de pagamento da faixa (integral ou sinal)	Integral	Configuração · aba Preços, em cada faixa	RN-PAG-03
Janela da conferência automática (`janela_reconciliacao_h`)	48 h	Só pela equipe técnica	RN-PAG-04
Frequência das rotinas (aviso do banco e conferência automática)	A cada 30 s e a cada 60 s	Só pela equipe técnica	RN-PAG-02, RN-PAG-04
Validade do crédito do cliente (dias)	90 dias	Parâmetros da unidade · Caixa, PIX e crédito	Situações especiais (PIX acima do valor)
Validade do PIX do balcão (min)	30 min	Parâmetros da unidade · Balcão e agenda	RN-PAG-08
WhatsApp de alerta do proprietário	Vazio (só o alerta na fila)	Parâmetros da unidade · Mensagens e alertas	RN-FIN-07
Horário da conciliação bancária	Todo dia às 6h, para o dia anterior	Só pela equipe técnica	RN-FIN-15

Fonte: docs/PRD-SGO.md, conferido contra o sistema em 18/10/2026 (docs/conferencia_regras.md). Os códigos RN levam à regra completa no PRD.