Ao finalizar este guia, você terá a chave pública, chave privada, segredo de eventos, segredo de integridade e URL de Eventos prontos para conectar o Wompi no Brain Studio.
Antes de começar
Você precisa de:- Uma conta ativa do Wompi
- Acesso ao dashboard do Wompi com permissões para visualizar credenciais técnicas
- Permissões para configurar a URL de Eventos
- Definir se conectará credenciais de Sandbox ou de Produção
Ambientes no Wompi
O Wompi separa as credenciais por ambiente:- Sandbox: ambiente de testes. Permite simular pagamentos sem mover dinheiro real.
- Produção: ambiente real. Processa transações com dinheiro real.
| Ambiente | Chave pública | Chave privada | Segredo de eventos | Segredo de integridade |
|---|---|---|---|---|
| Sandbox | pub_test_... | prv_test_... | test_events_... | test_integrity_... |
| Produção | pub_prod_... | prv_prod_... | prod_events_... | prod_integrity_... |
Parte 1 — Preparar credenciais Sandbox
Em Desenvolvimento → Programadores você encontra as credenciais técnicas do ambiente de testes e o campo URL de Eventos. Use esta seção para copiar as chaves e segredos Sandbox e para salvar a URL onde o Wompi notificará as mudanças de status das transações.
Confirmar modo de testes
Verifique se o modo de testes está ativo. No dashboard, você deve ver uma indicação de Sandbox ou modo de testes.Só continue se as credenciais mostrarem prefixos de teste:
pub_test_, prv_test_, test_events_ e test_integrity_.Copiar chaves e segredos Sandbox
Em Chaves do API para integração técnica, copie a Chave pública e a Chave privada.Em Segredos para integração técnica, copie Eventos e Integridade.
Configurar URL de Eventos
Em Monitoramento de transações, cole exatamente esta URL:Em seguida, clique em Salvar.
Se a URL de eventos ficar salva no Wompi, o Brain Studio poderá receber atualizações de status das transações.
Parte 2 — Preparar credenciais de Produção
As credenciais de Produção são preparadas na mesma tela Desenvolvimento → Programadores. Confirme que o modo de testes esteja desativado antes de copiar as chaves e segredos. Neste ambiente, você também deve salvar a URL de Eventos para que o Brain Studio receba as mudanças de status de pagamentos reais.
Desativar modo de testes
No dashboard do Wompi, desative o modo de testes para voltar ao ambiente de Produção.
Copiar chaves e segredos produtivos
Copie as credenciais do ambiente produtivo e verifique se todos os valores usam estes prefixos:
- Chave pública (
pub_prod_...) - Chave privada (
prv_prod_...) - Eventos (
prod_events_...) - Integridade (
prod_integrity_...)
Configurar URL de Eventos em Produção
Em Monitoramento de transações, confirme se a URL de Eventos está salva com:Se não estiver configurada, cole e clique em Salvar.
Usar credenciais no Brain Studio
Ao instalar o Wompi, o Brain Studio solicita:- Chave pública
- Chave privada
- Segredo de eventos
- Integridade
- IVA aplicado
Validar credenciais por ambiente
Antes de colar as credenciais no Brain Studio, revise os prefixos para confirmar que todos os valores pertencem ao mesmo ambiente.Credenciais Sandbox
Credenciais Sandbox
Prefixos que você verá no dashboard para o ambiente de testes:
pub_test_...prv_test_...test_events_...test_integrity_...
Credenciais de Produção
Credenciais de Produção
Prefixos que você verá no dashboard para o ambiente real:
pub_prod_...prv_prod_...prod_events_...prod_integrity_...
Resolução de problemas
Como testo um pagamento com credenciais Sandbox?
Como testo um pagamento com credenciais Sandbox?
Para testar pagamentos com credenciais Sandbox, use os dados de teste publicados pelo Wompi para cartões, Nequi, PSE e outros meios disponíveis no checkout.O passo completo está documentado em Uso e configuração.
Não encontro as credenciais técnicas
Não encontro as credenciais técnicas
Verifique se você está no dashboard correto do Wompi e se o seu usuário tem permissões para acessar Desenvolvimento → Programadores.Se não ver as chaves ou segredos, solicite acesso ao administrador da conta Wompi.
O Brain Studio não aceita as credenciais
O Brain Studio não aceita as credenciais
Confira se você copiou os valores completos e se todos correspondem ao mesmo ambiente.Não misture, por exemplo, uma chave
pub_test_... com um segredo prod_events_....O fluxo não avança depois do pagamento
O fluxo não avança depois do pagamento
Verifique se a URL de Eventos está configurada exatamente como:Confirme também se você está usando as credenciais do mesmo ambiente configurado no Brain Studio.
Estou testando em Sandbox e quero passar para produção
Estou testando em Sandbox e quero passar para produção
Você deve usar credenciais produtivas:
pub_prod_...prv_prod_...prod_events_...prod_integrity_...
Boas práticas
Não misturar ambientes
Não misturar ambientes
Mantenha as credenciais Sandbox e Produção separadas. Use sempre chaves e segredos do mesmo ambiente.
Proteger segredos
Proteger segredos
Não compartilhe a chave privada, o segredo de eventos nem o segredo de integridade em canais inseguros.Se suspeitar de exposição, rotacione as credenciais no Wompi e atualize a instalação no Brain Studio.
Validar eventos antes de produção
Validar eventos antes de produção
Antes de operar com pagamentos reais, confirme se o Wompi consegue enviar eventos para a URL configurada e se o fluxo no Brain Studio avança pelas saídas esperadas.
Próximo passo
Conectar no Brain Studio
Instale o Wompi usando as credenciais do ambiente que você vai usar e defina o IVA aplicado para a integração.