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

***

## 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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores.md) 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.

**1. 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**.

**2. Choose Try with Jelou**

In the connection modal, choose **Try with Jelou** and press **Continue**.

Screenshot pending: `modo-prueba-elegir-camino_es.png`

Choose Try with Jelou or Connect my account

**3. 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.

> [tab] Fixed country
>
> Gateways such as Wompi, Payphone, Conekta, Stripe, or Nuvei show the country already set.
>
> Screenshot pending: `modo-prueba-pais-fijo_es.png`
>
> Country, currency, and test limit with a fixed country

> [tab] Country selector
>
> In Mercado Pago and Kushki you choose the **Country**. Currency updates when the selection changes.
>
> Screenshot pending: `modo-prueba-selector-pais_es.png`
>
> Country selector in Try with Jelou

**4. 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.

Screenshot pending: `modo-prueba-aviso-integracion_es.png`

The integration is marked as test mode

**5. 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.

Screenshot pending: `modo-prueba-plantilla_es.png`

Installation complete and link to the template

> [!TIP]
>
> If you build your workflows with the Jelou CLI, run `jelou payments verify <workflow>` to check that the payment node is configured correctly and creates the payment link, without opening the test chat. See [`jelou payments`](https://docs.jelou.ai/en/guides/cli/marketplace#jelou-payments).

***

## 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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/stripe/cobertura-y-precios.md). |
| Wompi | Colombia | |

> [!NOTE]
>
> **DeUna** does not have test mode yet. Install it with **Connect my account** following the [Connect in Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/deuna/conectar-en-brain-studio.md) flow.

***

## Connect your account

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

**1. Start the connection**

From the gateway in **Marketplace**, the **Payments** node on Canvas, or another available entry point, start connecting your account.

Screenshot pending: `modo-prueba-conectar-cuenta_es.png`

Entry point to connect your account

**2. 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.

**3. Confirm**

After you confirm, the gateway is connected with your account. The workflow you already built stays in place.

> [!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**.

***

## Use cases

> [accordion] 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] 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] 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.

***

## Templates to get started

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

> [card] [Mercado Pago](https://apps.jelou.ai/studio/template/tpl_O22UyjnZwh)

> [card] [Kushki](https://apps.jelou.ai/studio/template/tpl_Vkk2T7cyIL)

> [card] [Wompi](https://apps.jelou.ai/studio/template/tpl_tWT6MFR0em)

> [card] [Conekta](https://apps.jelou.ai/studio/template/tpl_OtViiPoQlU)

> [card] [Payphone](https://apps.jelou.ai/studio/template/tpl_FYC4Qa4F6z)

> [card] [Nuvei](https://apps.jelou.ai/studio/template/tpl_c3H1d_dh0m)

> [card] [PayPal](https://apps.jelou.ai/studio/template/tpl_FGAKHxl22J)

> [card] [Stripe](https://apps.jelou.ai/studio/template/tpl_1bP-YNbRA3)

***

## Next steps

> [card] [Provider catalog](https://docs.jelou.ai/guides/integraciones/pagos/proveedores.md)
>
> Pick a gateway and follow its connection guide when you move to your account.

> [card] [Payment experiences](https://docs.jelou.ai/guides/integraciones/pagos/experiencias/tipos-de-experiencia.md)
>
> Embedded WebView, native experience, or external confirmation.

> [card] [Payments introduction](https://docs.jelou.ai/guides/integraciones/pagos/introduccion.md)
>
> Transaction statuses and the typical implementation flow.

> [card] [Connect Mercado Pago](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/conectar-en-brain-studio.md)
>
> Example of the **Connect my account** path when you already have credentials.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.