Teste: ambiente de testes. Permite simular pagamentos sem mover dinheiro real.
Produção: ambiente real. Processa transações com dinheiro real.
Cada ambiente tem seu próprio par de chaves e seu próprio webhook. Não misture credenciais nem webhooks de teste com os de produção.
Ambiente
Chave pública
Chave privada
Webhook
Teste
Visível em API Keys de teste
Você deve criá-la com Criar nova chave privada
Configure com Modo Teste ativo
Produção
Visível em API Keys de produção
Você deve criá-la com Criar nova chave privada
Configure com Modo Teste desativado
Não misture credenciais nem webhooks entre ambientes. Se uma única chave ou webhook pertencer a outro ambiente, a instalação pode falhar ou os status de pagamento podem não sincronizar corretamente.
O Conekta só permite copiar ou ver a chave privada no momento da criação. Se você perdê-la, deverá gerar uma nova.
No canto inferior esquerdo do painel, ative o interruptor Modo Teste.Você deve ver o aviso O modo de testes está habilitado na parte superior do painel.
3
Abrir Desenvolvedor
No menu lateral, abra Desenvolvedor.
Painel do Conekta com modo teste ativo, seção Desenvolvedores e card Webhooks
4
Consultar API Keys de teste
No card Ver API Keys, clique em Consultar API Keys de teste.
5
Copiar a chave pública
Na seção Chave pública, copie a chave ativa com Copiar chave.
API Keys de teste: chave pública e criação de chave privada
6
Criar e copiar a chave privada
Na seção Chaves privadas, clique em Criar nova chave privada.Atribua um nome descritivo, confirme a criação e copie a chave privada imediatamente. O Conekta não mostrará a chave completa novamente depois que você fechar essa etapa.
7
Abrir Webhooks de teste
Volte para Desenvolvedor. No card Webhooks, clique em Revisar webhooks.
8
Criar o webhook de teste
Clique em Criar Webhook e preencha:
URL do webhook:https://chat-payments.jelou.ai/link-webhook?provider=CONEKTA
Nome ou descrição: um nome descritivo, por exemplo Jelou Brain
Eventos a notificar: selecione os 5 eventos de orders indicados acima
Modal Criar Webhook no Conekta
Eventos de orders a selecionar no webhook
9
Confirmar webhook de teste ativo
Salve o webhook e verifique se fica Ativo com a URL da Jelou.
Parte 2 — Preparar credenciais e webhook de produção
1
Desativar modo teste
No canto inferior esquerdo do painel, desative o interruptor Modo Teste.Confirme que o aviso de modo de testes habilitado não aparece mais.
2
Abrir Desenvolvedor
No menu lateral, abra Desenvolvedor.
Painel do Conekta com modo teste desativado e seção Desenvolvedores
3
Consultar API Keys de produção
No card Ver API Keys, clique em Consultar API Keys de produção.
4
Copiar a chave pública
Na seção Chave pública, copie a chave ativa com Copiar chave.
API Keys de produção: chave pública e criação de chave privada
5
Criar e copiar a chave privada
Na seção Chaves privadas, clique em Criar nova chave privada.Atribua um nome descritivo, confirme a criação e copie a chave privada imediatamente.Quando passar o Conekta para produção no Brain Studio, use este par produtivo. Não reutilize credenciais de teste.
6
Abrir Webhooks de produção
Volte para Desenvolvedor. No card Webhooks, clique em Revisar webhooks.
7
Criar o webhook de produção
Clique em Criar Webhook e preencha a mesma configuração do teste:
URL do webhook:https://chat-payments.jelou.ai/link-webhook?provider=CONEKTA
Nome ou descrição: um nome descritivo, por exemplo Jelou Brain
Eventos a notificar: selecione os 5 eventos de orders indicados acima
Confirme que o webhook fique Ativo no ambiente de produção.
Chave pública ativa do ambiente que você está conectando
Chave privada
Chave privada que você acabou de criar no Conekta
IVA aplicado
Percentual de IVA que a integração utilizará durante a cobrança
O IVA é configurado durante a conexão no Brain Studio, não no painel do Conekta. O webhook é configurado diretamente no Conekta e não é inserido no Brain Studio.
