> For the complete documentation index, see [llms.txt](https://docs.tupayonline.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tupayonline.com/documentacion-de-la-api/tu-payplus/tu-plugin/vtex.md).

# Vtex

## <mark style="color:orange;">Objetivo</mark>

Este manual ha sido creado con el propósito de proporcionar instrucciones detalladas sobre
&#x20;cómo llevar a cabo la instalación correcta y exitosa del Conector de Pagos en el entorno
&#x20;vtex. Se encontrarán pasos claros y guías específicas diseñadas para asegurar la fluidez y
&#x20;eficiencia en la integración de pagos en la plataforma de comercio electrónico.

## <mark style="color:orange;">Instalación del conector de pagos Tupay en ambiente VTEX</mark>

### <mark style="color:blue;">Paso 1: Preparación</mark>

* Antes de comenzar con la instalación del Conector de Pagos, asegúrese de contar con las credenciales de acceso al panel de administración de VTEX.
* Asegúrese de contar con las credenciales para el conector de pagos Tupay.

### <mark style="color:blue;">Paso 2: Acceso al panel de administración VTEX</mark>

* Abra su navegador web y acceda al panel de administración de su tienda VTEX.
* Inicie sesión en su tienda VTEX.

### <mark style="color:blue;">Paso 3: Navegación al conector de pagos y configuración del mismo</mark>

* Una vez dentro del panel de administración, busque la sección de configuración de tienda en la parte inferior izquierda de la pantalla como se muestra en la imagen.

<figure><img src="/files/gMwoFypeORLEAxiL7U3l" alt=""><figcaption></figcaption></figure>

* Una vez en la sección de configuración, ingrese al menú de proveedores del módulo de pago.

<figure><img src="/files/GovXBWsJYihEgqEQQ4tC" alt=""><figcaption></figcaption></figure>

* En el panel de configuración, seleccionar el botón Nuevo Proveedor

<figure><img src="/files/BknNfhehsbBj5m0AxTIE" alt=""><figcaption></figcaption></figure>

* Es necesario configurar un nuevo proveedor, seleccionando de la lista o puede filtrar con el buscador.

<figure><img src="/files/E7XtWLbc2GGORMvmegdx" alt=""><figcaption></figcaption></figure>

* Clic sobre el proveedor TuPay.

<figure><img src="/files/K7KglLzphjMcPGvV9yJm" alt=""><figcaption></figcaption></figure>

* Luego de seleccionar el proveedor se abrirá un panel de configuración.

<figure><img src="/files/j7v78LfksafyNhdoiJpK" alt=""><figcaption></figcaption></figure>

Allí es necesario configurar las credenciales proporcionadas por Tupay.

#### <mark style="color:$primary;">Credenciales necesarias para configurar proveedor Tupay</mark>:

**Autorización del proveedor:**

* **AppKey**: Corresponde al API Key del portal de configuración de Tupay
* **AppToken**: Corresponde al API Signature del portal de configuración de Tupay

**Información general:**

* **Name**: TuPay (Este nombre puede modificarse según sea el caso)

**Control de pago**:

* **Enable Test Mode**: Este check permite indicar si esta configuración es de pruebas o es de producción, marcar en caso de que corresponda a pruebas.
* **Automatic Settlement**: Seleccionar opción Desactivado.

**Campos del proveedor:**

* **APIPassphrase**: Dejar como valor por defecto “0”
* **Expiration**: Tiempo en minutos en que se espera la expiración del pago
* **PaymentMethod**: Lista desplegable que contienen los medios de pago que se pueden utilizar:
  * Tupay
  * Tupay Billeteras digitales
  * Tupay Banca en línea
  * Tupay Tarjetas de crédito y débito

<figure><img src="/files/m4hpYOIMIOG27SZrgCf2" alt=""><figcaption></figcaption></figure>

* Una vez guardada la configuración puede verificar que el proveedor queda en el listado de proveedores.

<figure><img src="/files/FR9pbVXW6GxA7fMP1A6K" alt=""><figcaption></figcaption></figure>

* Después de configurar el proveedor, ingrese al menú de Configuración del módulo de pago.

<figure><img src="/files/Hxe0w3gzLY7aZuClS6Fj" alt=""><figcaption></figcaption></figure>

* Agregue una nueva condición de pago usando el icono verde en la parte superior derecha de la pantalla

<figure><img src="/files/kbIGnt24F4UGIcnSWUhn" alt=""><figcaption></figcaption></figure>

* Se abrirá un listado de condiciones de pago disponibles.

<figure><img src="/files/1nu0PTM7k4SbeMIIjaIs" alt=""><figcaption></figcaption></figure>

* Busque la condición de pago Tupay (Aquí puede seleccionar las condiciones de pago que vaya a utilizar en el checkout).

<figure><img src="/files/jTol0QiIwHKeA4NJJ6Vf" alt=""><figcaption></figcaption></figure>

* Una vez elegida la condición, aparecerá la pantalla de configuración para la

  condición de pago.

<figure><img src="/files/xWpzqvkMmtTgMk0TN6zl" alt=""><figcaption></figcaption></figure>

* Asigne nombre, active, elija el proveedor que acaba de configurar y guarde la

  configuración de la condición de pago.

<figure><img src="/files/Cb2hGoU4BeLJcPvgl6Nq" alt=""><figcaption></figcaption></figure>

* &#x20;Una vez configurada la condición de pago podrá verla en la lista de condiciones de pago.

<figure><img src="/files/jb9VbfL5nZWit7Pv7yTq" alt=""><figcaption></figcaption></figure>

### &#xD;<mark style="color:blue;">Paso 4: Verificación de configuración del conector</mark>

* Simule una compra y una vez en el checkout podrá ver la condición de pago

  configurada en este proceso

<figure><img src="/files/YGWIjpvl4Qerp0Eedm9Y" alt=""><figcaption></figcaption></figure>

* Al seleccionar “comprar ahora” una ventana modal será mostrada y allí podrá ver el código QR, esta ventana se cerrará automáticamente una vez confirmado o rechazado el pago.

<figure><img src="/files/EdvblUn5KGdAm5jhagPm" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/3xx9imB3aTKsVrnd9nhe" alt=""><figcaption></figcaption></figure>

### <mark style="color:blue;">Paso 5: Revision de transacciones</mark>

* Diríjase al menú lateral de pedidos.

<figure><img src="/files/sqtCNF73ftLYpfGIKrgr" alt=""><figcaption></figcaption></figure>

* Ingrese al submenú transacciones

<figure><img src="/files/3x68qnet9tVuhVVjYsOF" alt=""><figcaption></figcaption></figure>

* Allí podrá ver la lista de transacciones.

<figure><img src="/files/bddZqd37lQcOkNfB8sZA" alt=""><figcaption></figcaption></figure>

* Al ingresar a los elementos de la lista podrá ver los eventos para cada transacción.

<figure><img src="/files/NLcLq88KrjjumwTe6B0w" alt=""><figcaption></figcaption></figure>

* Para verificar información de los pedidos, ingrese al submenú Todos los pedidos.

<figure><img src="/files/8lnY8tWpKq7g20WOQi5B" alt=""><figcaption></figcaption></figure>

* Al ingresar a los elementos de la lista, podrá ver información del pago en la parte izquierda, en el recuadro de pago.

<figure><img src="/files/LRQb2436qAryoww9sWCG" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tupayonline.com/documentacion-de-la-api/tu-payplus/tu-plugin/vtex.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.