Visão geral dos pagamentos
Como o Pix funciona na sua loja, qual gateway escolher, onde configurar (site ou Discord) e como a confirmação automática libera a entrega.
Nesta página
Como o pagamento funciona
As vendas da sua loja são pagas por Pix. Você escolhe o gateway (a empresa que gera o Pix e recebe o dinheiro) e conecta a sua conta nele. A partir daí:
O cliente gera o Pix no Discord
O bot cria a cobrança no seu gateway, com QR Code e copia e cola, e reserva o estoque.
O cliente paga no app do banco
Com o seu próprio gateway (Efí ou Mercado Pago), o dinheiro cai direto na sua conta nele, e a Kyo não fica com nenhuma parte das vendas. No Kyo Pay, o Pix é recebido pela Kyo Applications, não por uma conta sua.
A Kyo confirma o pagamento com o gateway
Sem comprovante e sem ninguém conferir à mão. Confirmado, o pedido é liberado para entrega.
Qual gateway escolher
| Gateway | O que você precisa | Para quem é |
|---|---|---|
| Mercado Pago | Só o Access Token de produção. | O jeito mais rápido. Bom para quem já tem conta no Mercado Pago. |
| Efí Bank | Client ID, Client Secret, certificado .p12 e uma chave Pix. | Quem quer a API Pix oficial de um banco, com ambiente de homologação para testar. |
| Kyo Pay | Nada para preencher. | O Pix da própria Kyo, quando estiver liberado para a sua loja. |
Com Efí ou Mercado Pago, as taxas de Pix são as do seu contrato com o gateway. A Kyo não cobra comissão sobre as vendas.
Onde configurar
Dá para configurar nos dois lugares, com o mesmo resultado:
- No site: em Pagamentos, escolha o servidor e o gateway, siga o passo a passo, preencha as credenciais e clique em Testar e salvar.
- No Discord: use
/pagamentos(ou o botão 💳 Pagamentos do/kyo). Escolha o gateway na lista, toque em Informar credenciais e preencha o formulário. O certificado da Efí pode ser enviado no próprio formulário.
Sua lojaAPPhoje às 12:00
💳 Pagamentos da loja
Só você vê esta mensagem
📡 Situação
🟢 Conectado · Mercado Pago
🧭 Como funciona
➜ Escolha o gateway na lista abaixo e siga o passo a passo.
➜ Informe as credenciais no formulário: a conexão é testada antes de salvar, sem gerar cobrança.
➜ Vale para as próximas vendas em até 1 minuto, sem reiniciar o bot.
🔒 As credenciais ficam cifradas e nunca aparecem de novo, nem aqui nem no site.
Sua loja · Pagamentos
👁️ Só você pode ver esta mensagem
- A conexão é testada antes de salvar, sem gerar cobrança nenhuma. Se o teste falhar, nada é alterado e a configuração anterior continua valendo.
- Trocar de gateway vale para as próximas vendas em até 1 minuto, sem reiniciar o bot.
- Para trocar só um campo (por exemplo, a chave Pix), deixe os outros em branco: campos vazios mantêm o que já está salvo para o mesmo gateway e ambiente.
- Testar conexão confere de novo a configuração salva a qualquer momento. Desconectar (no site) remove as credenciais.
Confirmação automática
A Kyo usa dois caminhos ao mesmo tempo para não perder nenhum pagamento:
- Aviso do gateway (webhook): no Mercado Pago, o endereço de aviso vai junto em cada cobrança, sem você configurar nada.
- Conferência ativa: a Kyo pergunta ao gateway, cobrança por cobrança, se o Pix foi pago. Pix com menos de 30 minutos é conferido a cada minuto; depois, a cada 15 minutos. É isso que confirma os pagamentos da Efí.
Validade do Pix
Cada Pix vale 30 minutos por padrão. Mude em Configurações gerais, em Regras de compra (de 10 a 1440 minutos). Pix vencido cancela o pedido e devolve o estoque reservado. Se o cliente pagar depois de vencer, o pagamento ainda é honrado. Veja Pix, QR Code e validade.
Segurança das credenciais
- As credenciais são testadas e guardadas cifradas. Elas nunca aparecem de novo na tela, nem para a equipe da Kyo.
- O certificado .p12 da Efí fica cifrado no banco e nunca vira arquivo em disco.
- No Discord, tudo acontece em mensagens que só você vê, e só quem tem Gerenciar Servidor usa o
/pagamentos.