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

# Test mode

> Install a gateway and test charges end to end without your own account or credentials.

**Test mode** lets you install a gateway and validate a charge end to end **without your own account or credentials**.

Use it to test your workflow — amount, checkout, and **Approved** / **Rejected** results — before you connect your account and charge for real. When you're done validating, connect your account on the same installation. **You don't need to rebuild the workflow.**

<Warning>
  Test mode does not process real payments or settle funds. It has **up to 10 tests** per configuration.
</Warning>

***

## How it works

When you install a compatible gateway, you can choose how to start:

* **Try with Jelou:** test the integration without creating a provider account or entering your own credentials.
* **Connect my account:** connect your own test or production credentials. Follow that provider's [Connect in Brain Studio](/guides/integraciones/pagos/proveedores) guide.

If you choose **Try with Jelou**, you select the country (when applicable) and currency and VAT are set based on that selection. You have up to 10 tests to validate the flow.

***

## Install in test mode

You can start the installation from **Marketplace**, the **Payments** node on Canvas, **Jelou Agent**, or a compatible template.

<Steps>
  <Step title="Choose the gateway">
    When you go to install a gateway, pick the one you want to test.

    Test mode is available for Conekta, Kushki, Mercado Pago, Nuvei, PayPal, Payphone, Stripe, and Wompi.

    <Note>
      **DeUna** does not have test mode yet. It can only be installed with **Connect my account**.
    </Note>
  </Step>

  <Step title="Choose Try with Jelou">
    In the connection modal, choose **Try with Jelou** and press **Continue**.

    <Frame caption="Choose Try with Jelou or Connect my account">
      <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">
        Screenshot pending: <code>modo-prueba-elegir-camino\_es.png</code>
      </div>
    </Frame>
  </Step>

  <Step title="Confirm the country">
    Review the country, currency, and **Test limit**.

    If test mode for that gateway is available in a single country, it will come preselected. If it's available in several, choose the **Country** and the **Currency** will adjust automatically.

    <Warning>
      The country cannot be changed after installation. If you need a different country, disconnect the gateway and install it again.
    </Warning>

    <Tabs>
      <Tab title="Fixed country">
        Gateways such as Wompi, Payphone, Conekta, Stripe, or Nuvei show the country already set.

        <Frame caption="Country, currency, and test limit with a fixed country">
          <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">
            Screenshot pending: <code>modo-prueba-pais-fijo\_es.png</code>
          </div>
        </Frame>
      </Tab>

      <Tab title="Country selector">
        In Mercado Pago and Kushki you choose the **Country**. Currency updates when the selection changes.

        <Frame caption="Country selector in Try with 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">
            Screenshot pending: <code>modo-prueba-selector-pais\_es.png</code>
          </div>
        </Frame>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Install in test mode">
    Press **Install in test mode**. The gateway becomes available in your workspace in test mode.

    On the integration and on the **Payments** node you will see that it is in test mode.

    <Frame caption="The integration is marked as test mode">
      <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">
        Screenshot pending: <code>modo-prueba-aviso-integracion\_es.png</code>
      </div>
    </Frame>
  </Step>

  <Step title="Test with the template">
    When you finish, you can install a **template** with a workflow already set up: amount, test card, and messages based on the payment result. One click and it opens in Brain Studio ready to test.

    <Frame caption="Installation complete and link to the 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">
        Screenshot pending: <code>modo-prueba-plantilla\_es.png</code>
      </div>
    </Frame>
  </Step>
</Steps>

***

## Available gateways and countries

Test mode is available for each gateway in specific countries.

| Gateway      | Country(ies) in test mode                                 | Note                                                                                                                                                    |
| ------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Conekta      | Mexico                                                    |                                                                                                                                                         |
| Kushki       | Chile, Colombia, Ecuador, Mexico, Peru                    |                                                                                                                                                         |
| Mercado Pago | Argentina, Brazil, Chile, Colombia, Mexico, Peru, Uruguay |                                                                                                                                                         |
| Nuvei        | Ecuador                                                   |                                                                                                                                                         |
| PayPal       | Chile ¹                                                   | Test mode coverage does not limit your own PayPal account.                                                                                              |
| Payphone     | Ecuador                                                   |                                                                                                                                                         |
| Stripe       | United States ²                                           | Does not represent Stripe's coverage with your account. See [Coverage and pricing](/guides/integraciones/pagos/proveedores/stripe/cobertura-y-precios). |
| Wompi        | Colombia                                                  |                                                                                                                                                         |

<Note>
  **DeUna** does not have test mode yet. Install it with **Connect my account** following the [Connect in Brain Studio](/guides/integraciones/pagos/proveedores/deuna/conectar-en-brain-studio) flow.
</Note>

***

## Connect your account

To charge for real, connect your account on the same installation.

<Steps>
  <Step title="Start the connection">
    From the gateway in **Marketplace**, the **Payments** node on Canvas, or another available entry point, start connecting your account.

    <Frame caption="Entry point to connect your account">
      <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">
        Screenshot pending: <code>modo-prueba-conectar-cuenta\_es.png</code>
      </div>
    </Frame>
  </Step>

  <Step title="Enter your credentials">
    Fill in the provider's test or production credentials. Each field is documented in that gateway's **Connect in Brain Studio** guide.
  </Step>

  <Step title="Confirm">
    After you confirm, the gateway is connected with your account. The workflow you already built stays in place.
  </Step>
</Steps>

<Tip>
  If the country of your account does not match the one you chose in test mode, disconnect the gateway and install it again with **Connect my account**.
</Tip>

***

## Use cases

<AccordionGroup>
  <Accordion title="Build the workflow before having the merchant's account">
    A merchant hasn't delivered credentials yet: the team installs the gateway in test mode, opens the template, and validates checkout and the **Approved** / **Rejected** branches. When the credentials arrive, they connect the merchant's account without rebuilding the workflow.
  </Accordion>

  <Accordion title="Validate the payment experience in a market">
    A workflow that will charge in a specific market: Mercado Pago or Kushki is installed in test mode by choosing the corresponding **Country**. The team walks through checkout and validates the full flow before connecting the real account.
  </Accordion>

  <Accordion title="Evaluate a gateway before opening an account">
    A team deciding between gateways: they install Stripe or Kushki in test mode, complete a full payment, and discard the one that doesn't fit. No need to open a provider account for that comparison.
  </Accordion>
</AccordionGroup>

***

## Templates to get started

Want to test a gateway without building the workflow from scratch? Open its [template](/en/guides/getting-started/jelou-agent#turn-your-workflow-into-a-template) in Brain Studio and walk through a full charge in test mode.

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

***

## Next steps

<CardGroup cols={2}>
  <Card title="Provider catalog" href="/guides/integraciones/pagos/proveedores" icon="credit-card">
    Pick a gateway and follow its connection guide when you move to your account.
  </Card>

  <Card title="Payment experiences" href="/guides/integraciones/pagos/experiencias/tipos-de-experiencia" icon="puzzle">
    Embedded WebView, native experience, or external confirmation.
  </Card>

  <Card title="Payments introduction" href="/guides/integraciones/pagos/introduccion" icon="book-open">
    Transaction statuses and the typical implementation flow.
  </Card>

  <Card title="Connect Mercado Pago" href="/guides/integraciones/pagos/proveedores/mercado-pago/conectar-en-brain-studio" icon="plug">
    Example of the **Connect my account** path when you already have credentials.
  </Card>
</CardGroup>