Saúde do Pix

Como a Kyo confirma cada Pix (consulta ativa, trava de valor e revisão), o que cada resposta do gateway quer dizer, os estados normal, pausado e testando, rotas e sinais antifraude.

Nesta página

O que aparece em Agora
Como um pagamento é confirmado
O que cada resposta do gateway quer dizer
Normal, pausado e testando
Rotas do Pix e rodízio
Sinais antifraude
Pix agendado não é pagamento
Exemplo
Problemas comuns

Sitekyoapplications.com.br/dashboard/pagamentos/saude

A Saúde do Pix mostra se o Pix da loja está funcionando agora, como a Kyo confere cada pagamento antes de liberar e os sinais que pedem um olhar da equipe.

O que aparece em Agora

Abra Saúde do Pix, no grupo Loja do menu, e escolha o servidor. Para cada caminho do Pix (cada gateway que a loja usa) aparecem a situação, a última resposta boa, a última falha e a causa do último problema.

Loja no Pix fixo não tem gateway para acompanhar: cada pagamento é conferido por uma pessoa no extrato.
Sem gateway configurado, a página pede para escolher um em Pagamentos.

Como um pagamento é confirmado

São três travas, uma depois da outra. Se qualquer uma ficar em dúvida, a venda espera em vez de ser liberada.

As três travas do Pix

Consulta ativa. Aviso de pagamento nunca basta sozinho. A Kyo pergunta ao gateway, com a chave da loja, se aquele Pix foi pago. Se o gateway não responde, nada é concluído: ela tenta de novo depois.
Trava de valor. Só conta como pago se o gateway disser quanto entrou e o valor cobrir o cobrado. Valor menor, valor que não dá para conferir ou pagamento ligado a outro pedido não liberam.
Revisão da equipe. Tudo que a trava segura vai para Vendas › Conferências e para o Discord. Alguém da equipe olha o extrato e decide, com o nome registrado.

O que cada resposta do gateway quer dizer

Cada vez que a Kyo fala com o gateway, ele responde com um código (HTTP). O código diz se a conversa deu certo, não se o Pix foi pago. Por isso a Kyo lê o código e o conteúdo antes de decidir.

200 (e outros 2xx)
Em palavras simples: A conversa deu certo.
O que a Kyo faz: Lê o conteúdo. Se o conteúdo trouxer erro, trata como erro, mesmo com 200. Pago só se o conteúdo disser pago e o valor bater.

400 (e 404, 409, 422)
Em palavras simples: O gateway recusou o pedido do jeito que foi feito.
O que a Kyo faz: Não repete igual, porque não resolveria. Não conta como gateway com problema.

401 ou 403
Em palavras simples: O gateway não aceitou a chave ou o token da loja.
O que a Kyo faz: Não repete igual. Confira as credenciais em Pagamentos e use Testar conexão. Conta como falha do caminho.

429
Em palavras simples: Muitas chamadas seguidas. O gateway pediu para esperar.
O que a Kyo faz: Respeita a espera pedida (no máximo 10 minutos) e tenta de novo depois. Conta como falha do caminho.

5xx (500, 502, 503...)
Em palavras simples: Erro do lado do gateway.
O que a Kyo faz: Na criação do Pix: pode ter sido criado, então nunca repete no mesmo gateway. Na conferência: não conclui nada e confere de novo depois.

Sem resposta (tempo esgotado)
Em palavras simples: O gateway demorou demais ou a conexão caiu.
O que a Kyo faz: Igual ao 5xx: ninguém sabe o que aconteceu, então nada é concluído e a Kyo confere de novo depois.

Resposta	Em palavras simples	O que a Kyo faz
200 (e outros 2xx)	A conversa deu certo.	Lê o conteúdo. Se o conteúdo trouxer erro, trata como erro, mesmo com 200. Pago só se o conteúdo disser pago e o valor bater.
400 (e 404, 409, 422)	O gateway recusou o pedido do jeito que foi feito.	Não repete igual, porque não resolveria. Não conta como gateway com problema.
401 ou 403	O gateway não aceitou a chave ou o token da loja.	Não repete igual. Confira as credenciais em Pagamentos e use Testar conexão. Conta como falha do caminho.
429	Muitas chamadas seguidas. O gateway pediu para esperar.	Respeita a espera pedida (no máximo 10 minutos) e tenta de novo depois. Conta como falha do caminho.
5xx (500, 502, 503...)	Erro do lado do gateway.	Na criação do Pix: pode ter sido criado, então nunca repete no mesmo gateway. Na conferência: não conclui nada e confere de novo depois.
Sem resposta (tempo esgotado)	O gateway demorou demais ou a conexão caiu.	Igual ao 5xx: ninguém sabe o que aconteceu, então nada é concluído e a Kyo confere de novo depois.

Normal, pausado e testando

Cada caminho do Pix tem um disjuntor, igual ao da sua casa: desarma quando algo vai mal e religa sozinho, com cuidado.

Os três estados do disjuntor

Normal
O que quer dizer: Respondendo normalmente, ou sem nenhum problema registrado.

Com falhas
O que quer dizer: 3 ou mais falhas seguidas nas últimas conferências. Ainda não pausou. Nada é liberado sem confirmação.

Pausado
O que quer dizer: Falhou 5 vezes seguidas (ou o gateway pediu para esperar). Pix novos vão por outro caminho, quando existe.

Testando
O que quer dizer: Passou a pausa. O próximo Pix testa se ele voltou. Falhou de novo, pausa de novo.

Situação	O que quer dizer
Normal	Respondendo normalmente, ou sem nenhum problema registrado.
Com falhas	3 ou mais falhas seguidas nas últimas conferências. Ainda não pausou. Nada é liberado sem confirmação.
Pausado	Falhou 5 vezes seguidas (ou o gateway pediu para esperar). Pix novos vão por outro caminho, quando existe.
Testando	Passou a pausa. O próximo Pix testa se ele voltou. Falhou de novo, pausa de novo.

Falha que é do pedido (como um 400) não conta para pausar: o gateway está no ar.
Quando o gateway da própria loja pausa ou falha 3 vezes seguidas, a equipe recebe um aviso no Discord (com o bot ligado), no máximo 1 a cada 30 minutos. Ele sempre tenta a DM da equipe e, se o modo de aviso marca um canal, sai também no canal de alertas. Veja Avisos para a equipe.
Em Últimos problemas de pagamento ficam os erros agrupados. Quando o gateway volta ao normal, eles são marcados como resolvidos.

Rotas do Pix e rodízio

Com o Kyo Pay, cada Pix pode sair por mais de um caminho. Assim um gateway fora do ar não para as suas vendas. A página mostra qual rota está em uso:

Menor taxa
Como escolhe o caminho: Cada Pix vai pelo caminho mais barato para aquele valor. Se ele falhar, o outro assume.

Rodízio
Como escolhe o caminho: Cada Pix novo vai para o próximo caminho disponível, como uma fila de caixas: um cliente em cada caixa.

Prioridade
Como escolhe o caminho: Sempre o mesmo caminho primeiro. O segundo só entra quando o primeiro está pausado ou falha.

Rota	Como escolhe o caminho
Menor taxa	Cada Pix vai pelo caminho mais barato para aquele valor. Se ele falhar, o outro assume.
Rodízio	Cada Pix novo vai para o próximo caminho disponível, como uma fila de caixas: um cliente em cada caixa.
Prioridade	Sempre o mesmo caminho primeiro. O segundo só entra quando o primeiro está pausado ou falha.

A rota é a mesma para todas as lojas do Kyo Pay e quem escolhe é a Kyo. Em qualquer rota, a conferência de um Pix sempre volta ao caminho que o criou. Com o gateway da própria loja (Mercado Pago ou Efí), existe um caminho só e esta parte não aparece.

Sinais antifraude

A cada 10 minutos a Kyo confere de novo os pedidos pagos nas últimas 48 horas. Se algo estranho aparece, vira um sinal na página. Nada muda sozinho: o pedido não é alterado, nada é estornado e ninguém é bloqueado. A equipe decide.

Pago e depois devolvido
O que fazer: O Pix foi estornado, cancelado ou contestado depois da venda. Confira no extrato se o dinheiro saiu e fale com o comprador antes de entregar de novo. Este sinal também gera aviso no Discord.

Pagamento de outro pedido
O que fazer: O gateway liga este pagamento a outro pedido. Confira os dois no extrato antes de qualquer entrega.

Mesmo Pix em dois pedidos
O que fazer: Um único Pix aparece em mais de um pedido. Só um foi pago de verdade: confira qual no extrato.

Status voltou
O que fazer: O gateway mostra o pedido como pendente ou em disputa depois de pago. Acompanhe no painel do gateway.

Valor diferente
O que fazer: O gateway mostra um valor menor que o cobrado. Confira no extrato quanto entrou.

Pago depois de vencer
O que fazer: Normal quando o comprador demora. O pagamento é honrado; confira só se o estoque ainda existia.

Muitos Pix seguidos
O que fazer: A mesma pessoa gerou mais de 5 Pix pendentes em 10 minutos. Pode ser teste ou tentativa de segurar estoque. Observe antes de agir.

Sinal	O que fazer
Pago e depois devolvido	O Pix foi estornado, cancelado ou contestado depois da venda. Confira no extrato se o dinheiro saiu e fale com o comprador antes de entregar de novo. Este sinal também gera aviso no Discord.
Pagamento de outro pedido	O gateway liga este pagamento a outro pedido. Confira os dois no extrato antes de qualquer entrega.
Mesmo Pix em dois pedidos	Um único Pix aparece em mais de um pedido. Só um foi pago de verdade: confira qual no extrato.
Status voltou	O gateway mostra o pedido como pendente ou em disputa depois de pago. Acompanhe no painel do gateway.
Valor diferente	O gateway mostra um valor menor que o cobrado. Confira no extrato quanto entrou.
Pago depois de vencer	Normal quando o comprador demora. O pagamento é honrado; confira só se o estoque ainda existia.
Muitos Pix seguidos	A mesma pessoa gerou mais de 5 Pix pendentes em 10 minutos. Pode ser teste ou tentativa de segurar estoque. Observe antes de agir.

Cada sinal mostra a gravidade (alta, média ou baixa), o pedido e o comprador. Depois de conferir, toque em Resolvido para tirar da lista.

Recusou a credencial (HTTP 401 ou 403)
O que fazer: O token ou a chave mudou ou foi revogado. Gere de novo no gateway, conecte em Pagamentos e use Testar conexão.

Limite de chamadas (HTTP 429)
O que fazer: Espere. A Kyo já pausou e tenta de novo sozinha. Se repetir muito, fale com o gateway.

Erro no provedor (HTTP 5xx) ou demorou demais
O que fazer: O problema é do gateway. Os pedidos ficam esperando e são conferidos de novo. Acompanhe a página de status do gateway.

Pausado por muito tempo
O que fazer: Confira se a conta no gateway está ativa e com a chave Pix cadastrada. Teste a conexão em Pagamentos.

Comprador mandou comprovante e o pedido não liberou
O que fazer: A Kyo só libera com o gateway dizendo que foi pago. Confira no extrato. Veja O Pix não confirma em Solução de problemas.

Não deu para carregar os sinais agora
O que fazer: Recarregue a página em instantes.

O que aparece	O que fazer
Recusou a credencial (HTTP 401 ou 403)	O token ou a chave mudou ou foi revogado. Gere de novo no gateway, conecte em Pagamentos e use Testar conexão.
Limite de chamadas (HTTP 429)	Espere. A Kyo já pausou e tenta de novo sozinha. Se repetir muito, fale com o gateway.
Erro no provedor (HTTP 5xx) ou demorou demais	O problema é do gateway. Os pedidos ficam esperando e são conferidos de novo. Acompanhe a página de status do gateway.
Pausado por muito tempo	Confira se a conta no gateway está ativa e com a chave Pix cadastrada. Teste a conexão em Pagamentos.
Comprador mandou comprovante e o pedido não liberou	A Kyo só libera com o gateway dizendo que foi pago. Confira no extrato. Veja O Pix não confirma em Solução de problemas.
Não deu para carregar os sinais agora	Recarregue a página em instantes.