> ## 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 a chave pública, a chave privada, a assinatura de webhook e o ID de comércio do Kushki para conectar a integração no Brain Studio.

Prepare as credenciais de **teste** ou **produção** e solicite ao Kushki o webhook da Jelou.

<Check>
  Ao terminar, você terá a **chave pública**, a **chave privada**, a **assinatura de webhook** e o **ID de comércio**, com o webhook solicitado ao Kushki.
</Check>

***

## Antes de começar

Você precisa de:

* Decidir se usará credenciais de **teste** ou de **produção**
* Acesso de administrador ao console Kushki do ambiente correspondente
* Contatar o Kushki para configurar o webhook (não é criado em self-service)

***

## Ambientes no Kushki

O Kushki usa um console diferente por ambiente:

| Ambiente    | Console                                                                 | Contato                                                                       |
| ----------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Teste (UAT) | [uat-console.kushkipagos.com](https://uat-console.kushkipagos.com/auth) | [soporte@kushkipagos.com](mailto:soporte@kushkipagos.com)                     |
| Produção    | [console.kushkipagos.com](https://console.kushkipagos.com)              | [gaelle.depenanros@kushkipagos.com](mailto:gaelle.depenanros@kushkipagos.com) |

Onde copiar cada valor no console:

| Seção                             | Valor                                       |
| --------------------------------- | ------------------------------------------- |
| **Desenvolvedores → Credenciais** | Chave pública e chave privada               |
| **Desenvolvedores → Webhooks**    | Assinatura de webhook (`Webhook signature`) |
| **Meu Comércio**                  | ID de comércio                              |

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

***

## URL do webhook

Em teste e produção, o Kushki deve configurar esta URL:

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

<Note>
  Solicite a configuração por e-mail e inclua o seu **ID de comércio**. No Brain Studio você só informa a **assinatura de webhook**, não a URL.
</Note>

***

## Parte 1 — Ambiente de teste

<Steps>
  <Step title="Criar conta UAT">
    Cadastre-se em [https://uat-console.kushkipagos.com/auth/signup](https://uat-console.kushkipagos.com/auth/signup).

    Em seguida, inicie sessão em [https://uat-console.kushkipagos.com/auth](https://uat-console.kushkipagos.com/auth).
  </Step>

  <Step title="Copiar chave pública e chave privada">
    Abra **Desenvolvedores → Credenciais** e copie:

    * **Chave pública**
    * **Chave privada**

    <Frame caption="Console Kushki UAT: Desenvolvedores → Credenciais">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-dashboard-credenciales.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=2954e5ff410de531b99be4cdc2627d69" alt="Tela de Credenciais no Kushki com chave pública e chave privada" width="2876" height="1304" data-path="assets/images/integraciones/pagos/kushki-dashboard-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Copiar a assinatura de webhook">
    Abra **Desenvolvedores → Webhooks** e copie o valor de **Webhook signature**.

    <Frame caption="Console Kushki UAT: Desenvolvedores → Webhooks">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-dashboard-webhooks.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=e69c3c06720205b39ebcac694b16347c" alt="Tela de Webhooks no Kushki mostrando a assinatura de webhook" width="2872" height="1306" data-path="assets/images/integraciones/pagos/kushki-dashboard-webhooks.png" />
    </Frame>
  </Step>

  <Step title="Copiar o ID de comércio">
    Abra **Meu Comércio** e copie o **ID de Comércio**.

    <Frame caption="Console Kushki UAT: Meu Comércio">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-dashboard-mi-comercio.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=51dacf3e0e8c9176bb4537bf2ff47a71" alt="Tela Meu Comércio no Kushki com o ID de comércio" width="2880" height="1308" data-path="assets/images/integraciones/pagos/kushki-dashboard-mi-comercio.png" />
    </Frame>
  </Step>

  <Step title="Solicitar webhook e botão de pagamentos">
    Escreva para [soporte@kushkipagos.com](mailto:soporte@kushkipagos.com) com o seu **ID de Comércio** e solicite:

    * Configurar o webhook com `https://chat-payments.jelou.ai/kushki-webhook`
    * Ativar o serviço **botão de pagamentos** nesse ID de comércio
  </Step>

  <Step title="Configurar Botão de pagamentos">
    Quando o serviço estiver ativo, abra **Configuração → Integrações → Botão de Pagamentos**.

    <Frame caption="Configuração → Integrações → Botão de Pagamentos">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-configuracion-boton-pagos.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=35fe1cde2e45f02444413de35543a0d2" alt="Tela Configuração do Kushki com a opção Botão de Pagamentos em Integrações" width="2870" height="1298" data-path="assets/images/integraciones/pagos/kushki-configuracion-boton-pagos.png" />
    </Frame>

    Na aba **Avançado**, ative **Informação adicional de produto**.

    <Frame caption="Botão de Pagamentos → Avançado: Informação adicional de produto">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-boton-pagos-avanzado.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=3d1b877844d424504d3c4b706a7325e1" alt="Aba Avançado do Botão de Pagamentos com Informação adicional de produto ativada" width="968" height="1314" data-path="assets/images/integraciones/pagos/kushki-boton-pagos-avanzado.png" />
    </Frame>

    Em **Dados adicionais**, configure:

    * **Etiqueta:** `Detalle de la orden`
    * **Atributo:** `orderReferenceId`

    Salve as alterações.

    <Frame caption="Dados adicionais com atributo orderReferenceId">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-boton-pagos-order-reference.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=a17f5b5ab0dfd8cd0d8b11f6256cc1ae" alt="Configuração de dados adicionais com etiqueta Detalle de la orden e atributo orderReferenceId" width="946" height="600" data-path="assets/images/integraciones/pagos/kushki-boton-pagos-order-reference.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Guarde as quatro credenciais em local seguro. Você as usará ao instalar o Kushki no Brain Studio.
</Tip>

***

## Parte 2 — Ambiente de produção

A Jelou já está certificada como plataforma perante o Kushki. Você não precisa de certificação adicional do comerciante.

<Steps>
  <Step title="Solicitar acessos produtivos">
    Escreva para [gaelle.depenanros@kushkipagos.com](mailto:gaelle.depenanros@kushkipagos.com) (comercial / partnerships) e solicite:

    * Acessos ao console produtivo
    * Credenciais de produção
    * Configuração do webhook com `https://chat-payments.jelou.ai/kushki-webhook`
  </Step>

  <Step title="Entrar no console de produção">
    O Kushki enviará os acessos para [console.kushkipagos.com](https://console.kushkipagos.com). Inicie sessão com a conta produtiva.
  </Step>

  <Step title="Copiar as credenciais produtivas">
    Copie o mesmo conjunto de valores:

    * **Chave pública** e **chave privada** em **Desenvolvedores → Credenciais**
    * **Assinatura de webhook** em **Desenvolvedores → Webhooks**
    * **ID de comércio** em **Meu Comércio**

    Use este conjunto ao passar o Kushki para produção no Brain Studio. Não reutilize credenciais de teste.
  </Step>

  <Step title="Configurar Botão de pagamentos em produção">
    Repita a configuração de **Botão de Pagamentos** descrita na Parte 1:

    * Ative **Informação adicional de produto**
    * Em **Dados adicionais**, use a etiqueta `Detalle de la orden` e o atributo `orderReferenceId`
    * Salve as alterações
  </Step>
</Steps>

***

## O que o Brain Studio solicita

No passo 2 de 3 do modal de conexão, o Brain Studio pede:

| Campo                     | Descrição                                  |
| ------------------------- | ------------------------------------------ |
| **Chave pública**         | Chave pública do ambiente que você conecta |
| **Chave privada**         | Chave privada do ambiente que você conecta |
| **ID de comércio**        | Identificador do comerciante no Kushki     |
| **Assinatura de webhook** | Valor de **Webhook signature** no console  |

<Frame caption="Modal Conectar Kushki: passo 2 de 3 com as quatro credenciais">
  <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-conectar-credenciales.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=70f1a1a8571cc60ea81b75dee4b538df" alt="Modal do Brain Studio passo 2 de 3 para inserir chave pública, chave privada, ID de comércio e assinatura de webhook" width="1238" height="1016" data-path="assets/images/integraciones/pagos/kushki-conectar-credenciales.png" />
</Frame>

No passo 3 você define o **IVA aplicado** e a **moeda de cobrança**.

***

## Próximo passo

<Card title="Conectar no Brain Studio" href="/pt/guias/integracoes/pagamentos/provedores/kushki/conectar-no-brain-studio" icon="plug">
  Instale o Kushki com as credenciais do ambiente que você vai utilizar e defina o IVA e a moeda de cobrança.
</Card>
