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

# Introdução

> Implemente cobranças nos seus fluxos conversacionais usando provedores externos conectados ao Brain Studio.

Os pagamentos no Brain Studio permitem **iniciar, executar e confirmar cobranças** dentro de uma conversa (por exemplo, no WhatsApp) e continuar o fluxo com base no **resultado real da transação**.

A plataforma suporta diferentes [experiências de pagamento](/pt/guias/integracoes/pagamentos/experiencias/tipos-de-experiencia), dependendo do provedor e do método de pagamento utilizado:

* **WebView incorporado no WhatsApp**, onde o cliente conclui o checkout dentro da conversa.
* **Experiência nativa no chat**, quando o método de pagamento oferece suporte a isso.
* **Fluxos conversacionais para carteiras ou transferências**, quando a confirmação ocorre fora do checkout tradicional.

<Info>
  O Jelou não retém fundos. Cada usuário que implementa a solução usa sua própria conta e credenciais do provedor de pagamento correspondente.
</Info>

***

## Como funciona

Um pagamento no Brain Studio sempre envolve três funções claramente separadas:

* 🧠 **Brain Studio** → Constrói a solicitação e expõe o status
* 💳 **Provedor de pagamento** → Executa a transação e liquida os fundos
* 🎯 **Sua implementação** → Decide a próxima ação com base no status recebido

### Responsabilidades de cada parte

<Tabs>
  <Tab title="Brain Studio">
    * Constrói a solicitação (valor, moeda, metadados).
    * Aciona a operação em direção ao provedor.
    * Recebe o status e o expõe como resultado.
    * Não autoriza nem liquida pagamentos.
  </Tab>

  <Tab title="Provedor">
    * Executa o checkout ou a autorização de acordo com o método de pagamento.
    * Aplica validações e regras antifraude.
    * Determina o status final.
    * Liquida os fundos na conta do lojista.
  </Tab>
</Tabs>

### Status que você deve tratar

O provedor sempre retornará um **status de transação**.
Sua implementação deve tratá-lo de forma explícita.

<Accordion title="Aprovado">
  O pagamento foi confirmado com sucesso.

  Seu fluxo normalmente deve:

  * Continuar o processo principal.
  * Confirmar ao usuário.
  * Registrar o evento (se aplicável).
</Accordion>

<Accordion title="Rejeitado">
  A operação foi negada ou falhou.

  Seu fluxo deve:

  * Informar o erro.
  * Permitir nova tentativa ou um método alternativo.
  * Registrar o motivo, se o provedor o expuser.
</Accordion>

<Accordion title="Pendente (quando aplicável)">
  O pagamento ainda não tem uma confirmação final
  (comum para dinheiro em espécie ou transferências).

  Seu fluxo deve:

  * Definir uma estratégia de acompanhamento.
  * Consultar o status posteriormente (polling ou webhook).
  * Evitar continuar como se estivesse aprovado.
</Accordion>

<Info>
  Modele o nó de pagamento como uma transição determinística:
  <code>solicitação → execução externa → status → próxima ação</code>.
</Info>

***

## Modelo de integração (BYOK)

As integrações de pagamento do Marketplace funcionam, em sua maioria, com o modelo **BYOK (Bring Your Own Keys)**:

* Você conecta o provedor com **suas próprias credenciais** (API keys, Access Token ou OAuth).
* O pagamento é processado e liquidado na **conta do lojista** junto ao provedor.
* O Brain Studio **orquestra** o fluxo e trabalha com o **status retornado**.

<Tip>
  BYOK = você traz a conta e as chaves do provedor. O Brain Studio não substitui o provedor: ele o integra.
</Tip>

***

## Antes de implementar

<Tabs>
  <Tab title="Cobertura e método">
    Defina o escopo do seu caso de uso:

    * **País(es)** onde você irá operar.
    * **Métodos de pagamento** necessários (cartões, transferências, dinheiro, métodos locais).
    * Se o lojista já usa um provedor específico, comece por ele.
  </Tab>

  <Tab title="Experiência">
    A experiência depende do provedor e do tipo de integração disponível:

    * **WebView incorporado no WhatsApp**
    * **Experiência nativa no chat** (WhatsApp Flows, quando aplicável)
    * **Fluxos conversacionais** para carteiras/transferências (quando a confirmação ocorre fora do checkout)

    <Card title="Ver experiências de pagamento" icon={<span style={{ fontSize: '1.15rem', lineHeight: 1 }}>🧩</span>} href="/pt/guias/integracoes/pagamentos/experiencias/tipos-de-experiencia">
      Limites, diferenças e quando usar cada uma.
    </Card>
  </Tab>

  <Tab title="Requisitos técnicos">
    Lista de verificação mínima:

    * **Conta ativa** no provedor escolhido.
    * **Credenciais** prontas (API keys / Access Token / OAuth).
    * **WhatsApp Business verificado** se você for usar:
      * WebView incorporado
      * Experiência nativa com WhatsApp Flows

    <Warning>
      Se a conta do WhatsApp Business não estiver verificada, o WebView pode abrir em um navegador externo e a experiência nativa pode não estar disponível.
    </Warning>
  </Tab>
</Tabs>

***

## Fluxo de implementação típico

<Steps>
  <Step title="Escolher provedor e experiência">
    Defina o(s) país(es), método(s) de pagamento e a experiência (WebView / nativa / conversacional).
  </Step>

  <Step title="Obter credenciais">
    Gere as credenciais no painel do provedor (teste e/ou produção, dependendo do seu caso).
  </Step>

  <Step title="Instalar pelo Marketplace (BYOK)">
    Instale a integração e insira suas credenciais. O provedor fica disponível como uma ferramenta no Brain.
  </Step>

  <Step title="Usar no Brain e tratar os status">
    Implemente o pagamento no seu fluxo e trate explicitamente os status **Aprovado / Rejeitado / Pendente (quando aplicável)**.
  </Step>
</Steps>

<Tip>
  A prática recomendada é tratar o pagamento como uma "decisão baseada em status": o provedor retorna um status e seu fluxo continua pelo branch correto.
</Tip>

***

## Próximos passos

<CardGroup cols={3}>
  <Card title="Tutorial: Implementando sua primeira cobrança pelo WhatsApp" href="/pt/guias/integracoes/pagamentos/implementando-sua-primeira-cobranca" icon="rocket">
    Tutorial passo a passo: das credenciais à sua primeira cobrança em produção.
  </Card>

  <Card title="Experiências de pagamento" href="/pt/guias/integracoes/pagamentos/experiencias/tipos-de-experiencia" icon="puzzle">
    Quando usar WebView incorporado, experiência nativa no chat ou fluxos conversacionais.
  </Card>

  <Card title="Provedores disponíveis" href="/pt/guias/integracoes/pagamentos/provedores" icon="credit-card">
    Provedores por país, escopo de integração e guias específicos.
  </Card>
</CardGroup>