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

# Uso e configuração

> Adicione o nó do Kushki ao seu fluxo no Canvas, configure seus inputs e teste pagamentos em ambiente de teste.

Depois de conectada a integração, o nó do **Kushki** fica disponível no Canvas e permite criar experiências de cobrança com **WebView incorporado** dentro do fluxo conversacional.

<Tip>
  Se ainda não instalou a integração, siga primeiro [Conectar no Brain Studio](/pt/guias/integracoes/pagamentos/provedores/kushki/conectar-no-brain-studio).
</Tip>

***

## Adicionar o nó ao Canvas

<Steps>
  <Step title="Abrir seu fluxo no Canvas">
    Abra no Brain Studio o fluxo onde deseja incorporar a cobrança com Kushki.
  </Step>

  <Step title="Adicionar o nó Kushki">
    Adicione **Kushki** na barra de ferramentas do **Canvas**, no nó **Pagamentos**, ou a partir dos provedores de pagamento disponíveis depois que a integração estiver instalada.
  </Step>

  <Step title="Conectar o nó ao ponto de cobrança">
    Conecte o nó do Kushki depois que o fluxo já tiver o valor e a confirmação de compra.
  </Step>

  <Step title="Abrir o painel de configuração">
    Selecione o nó para abrir o painel lateral e completar os **inputs** e revisar as **saídas**.

    <Frame caption="Nó Kushki no Canvas com o painel Dados do pagamento">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-nodo-datos-del-pago.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=c6500efb1c7250bed16768bedcf0f60e" alt="Nó Kushki Pagamento WebView com saídas de pagamento e painel lateral em Dados do pagamento" width="1154" height="926" data-path="assets/images/integraciones/pagos/kushki-nodo-datos-del-pago.png" />
    </Frame>
  </Step>
</Steps>

***

## Configurar o nó

<Tabs>
  <Tab title="Inputs">
    ### Dados do pagamento

    <AccordionGroup>
      <Accordion title="Personalização" icon="message">
        <ParamField body="Personalização" type="boolean" default="false">
          Ative para definir as mensagens que acompanham o botão de pagamento.

          Se estiver desativado, o Brain Studio usa os textos padrão da mensagem de cobrança.
        </ParamField>
      </Accordion>

      <Accordion title="Motivo do pagamento" icon="file-lines">
        <ParamField body="Motivo do pagamento" type="string" required>
          Texto descritivo da cobrança. Exemplos: número do pedido, produto, serviço ou referência interna.

          Você pode mapeá-lo a partir de variáveis do fluxo, por exemplo `{{$memory.paymentBreakdown.summary}}`.
        </ParamField>
      </Accordion>

      <Accordion title="Valor sujeito a impostos" icon="receipt">
        <ParamField body="Valor sujeito a impostos" type="number" required>
          Valor sobre o qual se aplica o IVA. Apenas números.

          Você pode mapeá-lo a partir de variáveis do fluxo.
        </ParamField>
      </Accordion>

      <Accordion title="Valor isento de impostos" icon="dollar-sign">
        <ParamField body="Valor isento de impostos" type="number" required>
          Valor isento de impostos. Se não se aplicar, use `0`. Apenas números.

          Você pode mapeá-lo a partir de variáveis do fluxo.
        </ParamField>
      </Accordion>
    </AccordionGroup>

    <Note>
      O nó no Canvas expõe as saídas **Pagamento bem-sucedido**, **Pagamento pendente**, **Mensagem de pagamento enviada**, **Pagamento falhou** e **Erro**.
    </Note>

    ### Avançado

    <AccordionGroup>
      <Accordion title="Ambiente" icon="server">
        Mostra se o Kushki opera em **Desenvolvimento** ou **Produção**.

        Se estiver em **Desenvolvimento**, a partir daqui você pode iniciar **Passar para produção**.
      </Accordion>

      <Accordion title="Expiração do botão de pagamento" icon="clock">
        <ParamField body="Expiração do botão de pagamento" type="string">
          Define por quanto tempo o botão de pagamento permanece válido depois de enviado.
        </ParamField>
      </Accordion>
    </AccordionGroup>

    <Frame caption="Aba Avançado do nó Kushki">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=384162aa6b962dda00334667f8d39b41" alt="Painel Avançado do nó Kushki com ambiente Desenvolvimento e expiração do botão de pagamento" width="1162" height="656" data-path="assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png" />
    </Frame>
  </Tab>

  <Tab title="Outputs">
    <AccordionGroup>
      <Accordion title="Pagamento bem-sucedido" icon="circle-check">
        Ativa quando o Kushki confirma que a transação foi aprovada.

        Recomendações:

        * confirmar o pedido
        * emitir comprovante ou atualizar status em sistemas externos
      </Accordion>

      <Accordion title="Pagamento pendente" icon="clock">
        Ativa quando a transação fica em processamento ou requer confirmação posterior.

        Recomendações:

        * informar o usuário com clareza
        * evitar criar uma segunda cobrança enquanto o status se resolve
      </Accordion>

      <Accordion title="Mensagem de pagamento enviada" icon="paper-plane">
        Ativa quando a mensagem com o botão de pagamento é enviada corretamente na conversa.

        Esta saída **não** confirma o pagamento. Indica apenas que a mensagem foi enviada corretamente.
      </Accordion>

      <Accordion title="Pagamento falhou" icon="circle-xmark">
        Ativa quando a transação foi rejeitada, recusada ou não foi concluída.

        Recomendações:

        * permitir nova tentativa controlada
        * oferecer suporte ou um caminho alternativo
      </Accordion>

      <Accordion title="Erro" icon="triangle-exclamation">
        Ativa diante de erros técnicos, erros do provedor ou falhas de comunicação.

        Recomendações:

        * registrar o erro
        * mostrar mensagem de contingência
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

***

## Testar pagamentos em ambiente de teste

Se o Kushki estiver conectado com credenciais de **teste**, você pode testar o checkout com os dados de teste do Kushki.

<Note>
  Em ambiente de teste, o pagamento é fictício e não move dinheiro real.
</Note>

<Steps>
  <Step title="Confirmar credenciais de teste">
    Verifique se o Kushki está instalado com credenciais do ambiente de teste.
  </Step>

  <Step title="Configurar o nó">
    Complete **Motivo do pagamento**, **Valor sujeito a impostos** e **Valor isento de impostos**. Em **Avançado**, confirme que o ambiente é **Desenvolvimento**.
  </Step>

  <Step title="Testar a partir do WhatsApp">
    Dispare o fluxo a partir do WhatsApp, abra o checkout WebView do Kushki e conclua um pagamento de teste.
  </Step>

  <Step title="Validar a saída do fluxo">
    Verifique por qual saída o fluxo continua:

    * **Pagamento bem-sucedido**
    * **Pagamento pendente**
    * **Pagamento falhou**
    * **Erro**
  </Step>
</Steps>

***

## Passar para produção

Se você instalou o Kushki em **desenvolvimento/teste**, inicie a passagem para produção na aba **Avançado** do nó ou no **Marketplace**.

Antes de operar com pagamentos reais:

* Tenha as credenciais de **produção** prontas
* Use o fluxo descrito em [Conectar no Brain Studio](/pt/guias/integracoes/pagamentos/provedores/kushki/conectar-no-brain-studio)
* Lembre-se do custo de **US\$ 0,10** por transação em produção
* Execute um teste real de valor baixo antes de escalar

***

## Considerações importantes

<AccordionGroup>
  <Accordion title="O ambiente depende da instalação">
    Com credenciais de teste, use dados de teste. Com credenciais de produção, use dados reais.
  </Accordion>

  <Accordion title="Evite pagamentos duplicados">
    Em cenários pendentes ou falhos, informe com clareza antes de iniciar outra tentativa de cobrança.
  </Accordion>
</AccordionGroup>

***

## Próximo passo

<Card title="Cobertura e preços" href="/pt/guias/integracoes/pagamentos/provedores/kushki/cobertura-e-precos" icon="globe">
  Revise disponibilidade por país, moedas, métodos de pagamento e considerações comerciais do Kushki.
</Card>
