> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtenção de credenciais

> Obtenha as chaves e segredos do Wompi, configure a URL de eventos e prepare credenciais Sandbox ou Produção para conectar o Wompi no Brain Studio.

Este guia acompanha você na preparação de credenciais para testes e produção. Também cobre a configuração da URL de Eventos, necessária para que os estados de pagamento retornem corretamente aos seus fluxos no Brain Studio.

<Check>
  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.
</Check>

***

## 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.

Cada ambiente tem suas próprias chaves e segredos. Não misture credenciais de Sandbox com credenciais de Produção.

| 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_...`   |

<Warning>
  Não misture credenciais entre ambientes. Se uma única chave ou segredo pertencer a outro ambiente, a instalação pode falhar ou os eventos de pagamento podem não sincronizar corretamente.
</Warning>

***

## 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.

<Frame caption="Wompi Dashboard (Sandbox): chaves e segredos técnicos do comércio">
  <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-dashboard-sandbox-programadores.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=6772f2f8c9d47eb63f4b9a5f829a7a7d" alt="Dashboard do Wompi em Sandbox, seção Desenvolvimento Programadores: URL de Eventos, chave pública e privada, e segredos de Eventos e Integridade" width="1024" height="510" data-path="assets/images/integraciones/pagos/wompi-dashboard-sandbox-programadores.png" />
</Frame>

<Steps>
  <Step title="Entrar no dashboard do Wompi">
    Faça login no dashboard do Wompi com a conta do comércio.
  </Step>

  <Step title="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_`.
  </Step>

  <Step title="Abrir Desenvolvimento → Programadores">
    No menu lateral, abra **Desenvolvimento** e depois **Programadores**.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="Configurar URL de Eventos">
    Em **Monitoramento de transações**, cole exatamente esta URL:

    ```text theme={null}
    https://chat-payments.jelou.ai/wompi-webhook
    ```

    Em seguida, clique em **Salvar**.
  </Step>

  <Step title="Confirmar configuração Sandbox">
    Verifique se a URL de Eventos mantém a URL da Jelou após salvar e se todas as credenciais copiadas são de Sandbox.
  </Step>
</Steps>

<Check>
  Se a URL de eventos ficar salva no Wompi, o Brain Studio poderá receber atualizações de status das transações.
</Check>

***

## 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.

<Frame caption="Wompi Dashboard (Produção): chaves e segredos técnicos do comércio">
  <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-dashboard-produccion-programadores.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=218d4cc63256f7171dfd280cbae5df15" alt="Dashboard do Wompi em Produção, seção Desenvolvimento Programadores: URL de Eventos, chave pública e privada, e segredos de Eventos e Integridade" width="1024" height="509" data-path="assets/images/integraciones/pagos/wompi-dashboard-produccion-programadores.png" />
</Frame>

<Steps>
  <Step title="Desativar modo de testes">
    No dashboard do Wompi, desative o modo de testes para voltar ao ambiente de Produção.
  </Step>

  <Step title="Abrir Desenvolvimento → Programadores">
    No menu lateral, abra **Desenvolvimento** e depois **Programadores**.
  </Step>

  <Step title="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_...`)
  </Step>

  <Step title="Configurar URL de Eventos em Produção">
    Em **Monitoramento de transações**, confirme se a URL de Eventos está salva com:

    ```text theme={null}
    https://chat-payments.jelou.ai/wompi-webhook
    ```

    Se não estiver configurada, cole e clique em **Salvar**.
  </Step>

  <Step title="Usar credenciais produtivas no Brain Studio">
    Quando você passar o Wompi para produção no Brain Studio, use este conjunto produtivo completo. Não reutilize credenciais Sandbox.
  </Step>
</Steps>

<Warning>
  As credenciais de Produção processam pagamentos reais. Use-as apenas quando sua operação estiver pronta para cobrar.
</Warning>

***

## Usar credenciais no Brain Studio

Ao instalar o Wompi, o Brain Studio solicita:

* **Chave pública**
* **Chave privada**
* **Segredo de eventos**
* **Integridade**
* **IVA aplicado**

Use credenciais **Sandbox** quando conectar a integração em modo **desenvolvimento/teste**. Use credenciais **Produção** quando conectar a integração para operar com pagamentos reais.

Siga o guia [Conectar no Brain Studio](/pt/guias/integracoes/pagamentos/provedores/wompi/conectar-no-brain-studio) para completar a instalação.

***

## 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.

<AccordionGroup>
  <Accordion title="Credenciais Sandbox">
    Prefixos que você verá no dashboard para o ambiente de testes:

    * `pub_test_...`
    * `prv_test_...`
    * `test_events_...`
    * `test_integrity_...`
  </Accordion>

  <Accordion title="Credenciais de Produção">
    Prefixos que você verá no dashboard para o ambiente real:

    * `pub_prod_...`
    * `prv_prod_...`
    * `prod_events_...`
    * `prod_integrity_...`
  </Accordion>
</AccordionGroup>

<Warning>
  As operações de Sandbox não movem dinheiro real. Antes de operar em produção, use credenciais produtivas e confirme que a URL de Eventos esteja salva no ambiente correspondente.
</Warning>

***

## Resolução de problemas

<AccordionGroup>
  <Accordion title="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](/pt/guias/integracoes/pagamentos/provedores/wompi/uso-e-configuracao).
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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_...`.
  </Accordion>

  <Accordion title="O fluxo não avança depois do pagamento">
    Verifique se a **URL de Eventos** está configurada exatamente como:

    ```text theme={null}
    https://chat-payments.jelou.ai/wompi-webhook
    ```

    Confirme também se você está usando as credenciais do mesmo ambiente configurado no Brain Studio.
  </Accordion>

  <Accordion title="Estou testando em Sandbox e quero passar para produção">
    Você deve usar credenciais produtivas:

    * `pub_prod_...`
    * `prv_prod_...`
    * `prod_events_...`
    * `prod_integrity_...`

    Em seguida, use o fluxo **Passar para produção** no Brain Studio para substituir as credenciais Sandbox por credenciais produtivas.
  </Accordion>
</AccordionGroup>

***

## Boas práticas

<AccordionGroup>
  <Accordion title="Não misturar ambientes">
    Mantenha as credenciais Sandbox e Produção separadas. Use sempre chaves e segredos do mesmo ambiente.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Próximo passo

<Card title="Conectar no Brain Studio" href="/pt/guias/integracoes/pagamentos/provedores/wompi/conectar-no-brain-studio" icon="plug">
  Instale o Wompi usando as credenciais do ambiente que você vai usar e defina o IVA aplicado para a integração.
</Card>