Pular para o conteúdo principal
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, 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.
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.

​
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

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

​
Status que você deve tratar

O provedor sempre retornará um status de transação. Sua implementação deve tratá-lo de forma explícita.
O pagamento foi confirmado com sucesso.Seu fluxo normalmente deve:
  • Continuar o processo principal.
  • Confirmar ao usuário.
  • Registrar o evento (se aplicável).
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.
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.
Modele o nó de pagamento como uma transição determinística: solicitação → execução externa → status → próxima ação.

​
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.
BYOK = você traz a conta e as chaves do provedor. O Brain Studio não substitui o provedor: ele o integra.

​
Antes de implementar

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.

​
Fluxo de implementação típico

1

Escolher provedor e experiência

Defina o(s) país(es), método(s) de pagamento e a experiência (WebView / nativa / conversacional).
2

Obter credenciais

Gere as credenciais no painel do provedor (teste e/ou produção, dependendo do seu caso).
3

Instalar pelo Marketplace (BYOK)

Instale a integração e insira suas credenciais. O provedor fica disponível como uma ferramenta no Brain.
4

Usar no Brain e tratar os status

Implemente o pagamento no seu fluxo e trate explicitamente os status Aprovado / Rejeitado / Pendente (quando aplicável).
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.

​
Próximos passos

Tutorial: Implementando sua primeira cobrança pelo WhatsApp

Tutorial passo a passo: das credenciais à sua primeira cobrança em produção.

Experiências de pagamento

Quando usar WebView incorporado, experiência nativa no chat ou fluxos conversacionais.

Provedores disponíveis

Provedores por país, escopo de integração e guias específicos.