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

# Modo de teste

> Instale um gateway e teste cobranças de ponta a ponta sem conta nem credenciais próprias.

O **modo de teste** permite instalar um gateway e validar uma cobrança de ponta a ponta **sem conta nem credenciais próprias**.

Use para testar seu workflow — valor, checkout e resultados de **Aprovado** / **Recusado** — antes de conectar sua conta e cobrar de verdade. Quando terminar de validar, conecte sua conta sobre a mesma instalação. **Não precisa remontar o workflow.**

<Warning>
  O modo de teste não processa pagamentos reais nem liquida fundos. Tem **até 10 testes** por configuração.
</Warning>

***

## Como funciona

Quando você instala um gateway compatível, pode escolher como começar:

* **Testar com a Jelou:** teste a integração sem criar conta no provedor nem inserir credenciais próprias.
* **Conectar minha conta:** conecte suas credenciais de teste ou produção. Siga o guia [Conectar no Brain Studio](/pt/guias/integracoes/pagamentos/provedores) do provedor.

Se você escolher **Testar com a Jelou**, seleciona o país (quando se aplica) e a moeda e o IVA são configurados conforme essa seleção. Você tem até 10 testes para validar o fluxo.

***

## Instalar no modo de teste

Você pode iniciar a instalação pelo **Marketplace**, pelo nó **Pagamentos** no Canvas, pelo **Jelou Agent** ou por um template compatível.

<Steps>
  <Step title="Escolher o gateway">
    Quando for instalar um gateway, escolha o que quer testar.

    O modo de teste está disponível em Conekta, Kushki, Mercado Pago, Nuvei, PayPal, Payphone, Stripe e Wompi.

    <Note>
      A **DeUna** ainda não tem modo de teste. Esse gateway se instala só com **Conectar minha conta**.
    </Note>
  </Step>

  <Step title="Escolher Testar com a Jelou">
    No modal de conexão, escolha **Testar com a Jelou** e pressione **Continuar**.

    <Frame caption="Escolha Testar com a Jelou ou Conectar minha conta">
      <div className="flex items-center justify-center rounded-xl border border-dashed border-gray-300 bg-gray-50 px-6 py-16 text-center text-sm text-gray-500 dark:border-gray-600 dark:bg-gray-900 dark:text-gray-400">
        Captura pendente: <code>modo-prueba-elegir-camino\_es.png</code>
      </div>
    </Frame>
  </Step>

  <Step title="Confirmar o país">
    Revise o país, a moeda e o **Limite de testes**.

    Se o modo de teste desse gateway está disponível para um só país, virá pré-selecionado. Se está disponível para vários, escolha o **País** e a **Moeda** se ajustará automaticamente.

    <Warning>
      O país não pode ser alterado após a instalação. Se precisar de outro país, desconecte o gateway e instale de novo.
    </Warning>

    <Tabs>
      <Tab title="País fixo">
        Gateways como Wompi, Payphone, Conekta, Stripe ou Nuvei mostram o país já definido.

        <Frame caption="País, moeda e limite de testes com país fixo">
          <div className="flex items-center justify-center rounded-xl border border-dashed border-gray-300 bg-gray-50 px-6 py-16 text-center text-sm text-gray-500 dark:border-gray-600 dark:bg-gray-900 dark:text-gray-400">
            Captura pendente: <code>modo-prueba-pais-fijo\_es.png</code>
          </div>
        </Frame>
      </Tab>

      <Tab title="Seletor de país">
        No Mercado Pago e na Kushki você escolhe o **País**. A moeda atualiza ao mudar a seleção.

        <Frame caption="Seletor de país em Testar com a Jelou">
          <div className="flex items-center justify-center rounded-xl border border-dashed border-gray-300 bg-gray-50 px-6 py-16 text-center text-sm text-gray-500 dark:border-gray-600 dark:bg-gray-900 dark:text-gray-400">
            Captura pendente: <code>modo-prueba-selector-pais\_es.png</code>
          </div>
        </Frame>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Instalar no modo de teste">
    Pressione **Instalar no modo de teste**. O gateway fica disponível no seu workspace no modo de teste.

    Na integração e no nó **Pagamentos** você verá que está no modo de teste.

    <Frame caption="A integração fica marcada no modo de teste">
      <div className="flex items-center justify-center rounded-xl border border-dashed border-gray-300 bg-gray-50 px-6 py-16 text-center text-sm text-gray-500 dark:border-gray-600 dark:bg-gray-900 dark:text-gray-400">
        Captura pendente: <code>modo-prueba-aviso-integracion\_es.png</code>
      </div>
    </Frame>
  </Step>

  <Step title="Testar com o template">
    Ao terminar, você pode instalar um **template** com um workflow já montado: valor, cartão de teste e mensagens conforme o resultado do pagamento. Um clique e ele abre no Brain Studio pronto para testar.

    <Frame caption="Instalação concluída e link para o template">
      <div className="flex items-center justify-center rounded-xl border border-dashed border-gray-300 bg-gray-50 px-6 py-16 text-center text-sm text-gray-500 dark:border-gray-600 dark:bg-gray-900 dark:text-gray-400">
        Captura pendente: <code>modo-prueba-plantilla\_es.png</code>
      </div>
    </Frame>
  </Step>
</Steps>

***

## Gateways e países disponíveis

O modo de teste está disponível para cada gateway em determinados países.

| Gateway      | País(es) no modo de teste                                 | Nota                                                                                                                                                   |
| ------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Conekta      | México                                                    |                                                                                                                                                        |
| Kushki       | Chile, Colômbia, Equador, México, Peru                    |                                                                                                                                                        |
| Mercado Pago | Argentina, Brasil, Chile, Colômbia, México, Peru, Uruguai |                                                                                                                                                        |
| Nuvei        | Equador                                                   |                                                                                                                                                        |
| PayPal       | Chile ¹                                                   | A cobertura no modo de teste não limita a sua própria conta de PayPal.                                                                                 |
| Payphone     | Equador                                                   |                                                                                                                                                        |
| Stripe       | Estados Unidos ²                                          | Não representa a cobertura do Stripe com a sua conta. Ver [Cobertura e preços](/pt/guias/integracoes/pagamentos/provedores/stripe/cobertura-e-precos). |
| Wompi        | Colômbia                                                  |                                                                                                                                                        |

<Note>
  A **DeUna** ainda não tem modo de teste. Instale com **Conectar minha conta** seguindo o fluxo de [Conectar no Brain Studio](/pt/guias/integracoes/pagamentos/provedores/deuna/conectar-no-brain-studio).
</Note>

***

## Conectar sua conta

Para cobrar de verdade, conecte sua conta sobre a mesma instalação.

<Steps>
  <Step title="Iniciar a conexão">
    No gateway em **Marketplace**, no nó **Pagamentos** no Canvas ou em outro ponto de entrada disponível, inicie a conexão da sua conta.

    <Frame caption="Ponto de entrada para conectar sua conta">
      <div className="flex items-center justify-center rounded-xl border border-dashed border-gray-300 bg-gray-50 px-6 py-16 text-center text-sm text-gray-500 dark:border-gray-600 dark:bg-gray-900 dark:text-gray-400">
        Captura pendente: <code>modo-prueba-conectar-cuenta\_es.png</code>
      </div>
    </Frame>
  </Step>

  <Step title="Inserir suas credenciais">
    Preencha as credenciais de teste ou de produção do provedor. O detalhe de cada campo está no guia **Conectar no Brain Studio** desse gateway.
  </Step>

  <Step title="Confirmar">
    Ao confirmar, o gateway fica conectado com a sua conta. O workflow que você já montou se mantém.
  </Step>
</Steps>

<Tip>
  Se o país da sua conta não coincidir com o que você escolheu no modo de teste, desconecte o gateway e instale de novo com **Conectar minha conta**.
</Tip>

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Montar o workflow antes de ter a conta do lojista">
    Um lojista ainda não entregou suas credenciais: a equipe instala o gateway no modo de teste, abre o template e valida o checkout e os ramos de **Aprovado** / **Recusado**. Quando as credenciais chegam, conecta a conta do lojista sem remontar o workflow.
  </Accordion>

  <Accordion title="Validar a experiência de pagamento em um mercado">
    Um workflow que vai cobrar em um mercado específico: o Mercado Pago ou a Kushki é instalado no modo de teste escolhendo o **País** correspondente. A equipe percorre o checkout e valida o fluxo completo antes de conectar a conta própria.
  </Accordion>

  <Accordion title="Avaliar um gateway antes de abrir conta">
    Uma equipe decidindo entre gateways: instala Stripe ou Kushki no modo de teste, percorre um pagamento completo e descarta o que não encaixar. Sem precisar abrir conta no provedor para essa comparação.
  </Accordion>
</AccordionGroup>

***

## Templates para começar

Quer testar um gateway sem montar o workflow do zero? Abra o [template](/pt/guias/primeiros-passos/agente-jelou#transforme-seu-workflow-em-um-template) no Brain Studio e percorra uma cobrança completa no modo de teste.

<CardGroup cols={2}>
  <Card
    title="Mercado Pago"
    href="https://apps.jelou.ai/studio/template/tpl_O22UyjnZwh"
    icon={
  <svg className="h-6 w-6" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <image xlinkHref="/assets/images/providers/mercado-pago.svg" width="24" height="24" x="0" y="0" preserveAspectRatio="xMidYMid meet" />
  </svg>
}
  />

  <Card
    title="Kushki"
    href="https://apps.jelou.ai/studio/template/tpl_Vkk2T7cyIL"
    icon={
  <svg className="h-6 w-6" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <image xlinkHref="/assets/images/providers/kushki.svg" width="24" height="24" x="0" y="0" preserveAspectRatio="xMidYMid meet" />
  </svg>
}
  />

  <Card
    title="Wompi"
    href="https://apps.jelou.ai/studio/template/tpl_tWT6MFR0em"
    icon={
  <svg className="h-6 w-6" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <image xlinkHref="/assets/images/providers/wompi.svg" width="24" height="24" x="0" y="0" preserveAspectRatio="xMidYMid meet" />
  </svg>
}
  />

  <Card
    title="Conekta"
    href="https://apps.jelou.ai/studio/template/tpl_OtViiPoQlU"
    icon={
  <svg className="h-6 w-6" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <image xlinkHref="/assets/images/providers/conekta.svg" width="24" height="24" x="0" y="0" preserveAspectRatio="xMidYMid meet" />
  </svg>
}
  />

  <Card
    title="Payphone"
    href="https://apps.jelou.ai/studio/template/tpl_FYC4Qa4F6z"
    icon={
  <svg className="h-6 w-6" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <image xlinkHref="/assets/images/providers/payphone.svg" width="24" height="24" x="0" y="0" preserveAspectRatio="xMidYMid meet" />
  </svg>
}
  />

  <Card
    title="Nuvei"
    href="https://apps.jelou.ai/studio/template/tpl_c3H1d_dh0m"
    icon={
  <svg className="h-6 w-6" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <image xlinkHref="/assets/images/providers/nuvei.svg" width="24" height="24" x="0" y="0" preserveAspectRatio="xMidYMid meet" />
  </svg>
}
  />

  <Card
    title="PayPal"
    href="https://apps.jelou.ai/studio/template/tpl_FGAKHxl22J"
    icon={
  <svg className="h-6 w-6" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <image xlinkHref="/assets/images/providers/paypal.svg" width="24" height="24" x="0" y="0" preserveAspectRatio="xMidYMid meet" />
  </svg>
}
  />

  <Card
    title="Stripe"
    href="https://apps.jelou.ai/studio/template/tpl_1bP-YNbRA3"
    icon={
  <svg className="h-6 w-6" width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink">
    <image xlinkHref="/assets/images/providers/stripe.svg" width="24" height="24" x="0" y="0" preserveAspectRatio="xMidYMid meet" />
  </svg>
}
  />
</CardGroup>

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Catálogo de provedores" href="/pt/guias/integracoes/pagamentos/provedores" icon="credit-card">
    Escolha o gateway e siga o guia de conexão quando passar para a sua conta.
  </Card>

  <Card title="Experiências de pagamento" href="/pt/guias/integracoes/pagamentos/experiencias/tipos-de-experiencia" icon="puzzle">
    WebView incorporado, experiência nativa ou confirmação externa.
  </Card>

  <Card title="Introdução a pagamentos" href="/pt/guias/integracoes/pagamentos/introducao" icon="book-open">
    Status da transação e fluxo típico de implementação.
  </Card>

  <Card title="Conectar Mercado Pago" href="/pt/guias/integracoes/pagamentos/provedores/mercado-pago/conectar-no-brain-studio" icon="plug">
    Exemplo do caminho **Conectar minha conta** quando você já tem credenciais.
  </Card>
</CardGroup>
