# Go Cuotas

# Español

Guia en Español de Go Cuotas

# Introducción

**Go Cuotas** le permite a tus clientes abonar en **CUOTAS** **sin interés** con tarjetas de **débito**. Proporcionale a tus clientes una experiencia de compra sin complicaciónes con **Go Cuotas**

![Browser.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/E0QaA2w2kfim061b-browser.png)

# Instalación

#### Requerimientos

- **PHP:** &gt;= 7.4
- **Magento 2:** 2.3.x (2.3.3 / 2.3.6) - **2.4.x**
- Cuenta en **[Go Cuotas](https://u.magerocket.com/9d9fbc)**

<p class="callout warning">**IMPORTANTE**: La moneda de la tienda debe estar configurada en **Pesos Argentinos** (**ARS**) <span style="text-decoration: underline;">de lo contrario el método de pago no estará disponible</span></p>

#### Instalación 

Para instalar Go Cuotas en tu tienda deberas seguir estos pasos:

1\. Requerir el módulo desde Composer - **Recomendado Magento 2.4.x**

```
composer require magerocket/module-gocuotas
```

<p class="callout info">Para Magento **2.3.3** &lt;= **2.3.6** se deben instalar los siguientes Paquetes</p>

```
composer require magerocket/module-gocuotas-m23
composer require magerocket/module-core-m23
```

2\. Habilitar el modulo

```
php bin/magento module:enable MageRocket_GoCuotas MageRocket_Core
```

3\. Correr Setup Upgrade:

```
bin/magento setup:upgrade
```

¡Listo! Ahora estamos en condiciones de pasar a la **Configuración del Módulo**

# Configuraciónes

**1)** Nos posicionamos sobre el icono de **MageRocket,** clickeamos y a continuación hacemos click sobre **Configuraciones**

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/BX8EUorwJExkB6Bb-image.png)

<p class="callout info">En caso que no te salga el menú podes acceder desde **Tiendas &gt; Configuraciones &gt; Ventas &gt; Métodos de Pago**</p>

**2)** Ahora debemos buscar el Método de Pago **Go Cuotas** y damos clic en **Configurar**

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/AjjFXIxm5ehZese5-image.png)

**3)** Una vez clickeado el botón se desplegarán todas las configuraciones disponibles

Lo primero que debemos hacer es **configurar las credenciales, Método de Pago** (Redirect o Modal) y **Entorno** (Pruebas o Producción)

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-04/scaled-1680-/KEEFlKA8pgzi2sWu-image.png)

- **Habilitado:** Determina si el método de pago está disponible
- **Entorno**: Determina si el módulo funciona en modo **Pruebas** o **Producción**
- **Descripción:** Te permite modificar la descripción que vera el cliente en el checkout
- **Método de Pago:** Modal o Redireccionamiento. Determina si se abrirá un modal para completar el pago o si se redirecionará el cliente al sitio de Go Cuotas para realizar el pago.
- **Posición en Checkout**: Permite definicir la posición del método de pago en el checkout.  
      
    #### **Configuración de Credenciales**
    
    ![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/9ejLeww2ZJjXx8sa-image.png)
- **Credenciales Productivas / Credenciales Desarrollo** **(Pruebas)**: Deberas completar el **Email** y **Contraseña** provistas por **Go Cuotas**. Recorda que cada entorno tiene sus propias credenciales.

####  **Configuración de Pedidos**

Desde acá podrás configurar los estados para pedidos con **Pago Aprobado** y **Pagos Rechazados** o **Cancelado por el Usuario**

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/2ds8OqXCBtN3ehQN-image.png)

- **Status for Approved Orders:** Mostrará todos los estados asociados al **Status Processing.** Valor por Defecto: **Processing**
- **Status for Rejeced Orders:** Mostrará todos los estados asocaidos al **Status Canceled.** Valor por Defecto: **Canceled**

#### **Configuración de Cron <span style="color: rgb(224, 62, 45);"><sup>(GoCuotas v1.0.4)</sup></span>**

A partir de la versión **1.0.4**, es posible personalizar el tiempo de espera antes de que Magento cancele automáticamente un pedido debido a la falta de pago.  
El tiempo de espera puede configurarse **a** **partir de un mínimo de 30 minutos** (valor predeterminado). Si decides aumentar este tiempo, siempre deberá expresarse en minutos.

[![Cron Group](https://docs.magerocket.com/uploads/images/gallery/2024-11/scaled-1680-/7OiKeiiO14EhkN6h-cron-group.jpeg)](https://docs.magerocket.com/uploads/images/gallery/2024-11/7OiKeiiO14EhkN6h-cron-group.jpeg)

#### **Configuración de Reembolsos**

Esta sección te permite habilitar los **Reembolsos** y configurar hasta cuantos días como máximo se puede generar un reembolso

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/IaoUnGtFFLLVwxjF-image.png)

- **Reembolsos:** Permite activar / desactivar las Devoluciones
- **Cantidad de Días permitidos para reembolso:** Pasado los dias configurados no será posible **Reembolsar el Pago**

<p class="callout warning align-left">**ES POSIBLE REALIZAR UN ÚNICO REEMBOLSO TOTAL O PARCIAL.**</p>


####  **Configuración de Widgets**

Desde acá podrás **habilitar** / **deshabilitar** y **personalizar** el Widget que se muestra en la **Página del Producto**.  
Si debeas modificar le texto del widget y mantener la <span style="text-decoration: underline;">cantindad de cuotas</span> e <span style="text-decoration: underline;">importes</span> de la misma deberás utilizar **%1** y **%2** respectivamente donde quieras mostrarlos

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/HFHtT0neAH76L3jG-image.png)

#### **Configuración de Checkout**

Desde acá podrás modificar opciones del Método de Pago en el checkout.

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/DsEVmSD3M0zbfNPj-image.png)

- **Mostrar Banner en Checkout**: Mostrar / Ocultar banner.
- **Personalizar Banner:** Permite reemplazar el banner por uno custom.
- **Instrucciones Modal**: Modificar el mensaje que ve el cliente a la hora de abonar con el método **Modal.**
- **Instrucciones Redirect:** Mensaje que ve el cliente a la hora de abonar con el método **Redireccionamiento.**

#### **Otras Configuraciónes** 

Aca encontrarás configuraciones poco frecuentes

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-04/scaled-1680-/p8hG2Fr9rdCQLT1C-image.png)

- **Debug Mode:** Permite activar / desactivar los reportes extendidos.
- **Secret:** Firma única para autenticar las notificaciones de **Go Cuotas.**

<details id="bkmrk-since-v1.0.3-regener"><summary>Go Cuotas v1.0.3</summary>

- **RE-GENERAR SECRET:** Te permite regenerar el Secret.

</details><p class="callout danger">**Bajo ninguna circunstancia se debe modificar el Secret. Hacerlo va a ocacionar la cancelación de órdenes pendientes.**</p>

# Flujo de Pedidos

1. Deberás dirigirte a **Ventas &gt; Pedidos.** Abrir un pedido abonado con **Go Cuotas**
2. Ahora nos desplazamos hasta **Pago y Método de Envio**.
3. En la sección **Payment &amp; Shipping Mehtod** encontrás información rápida sobre el pago (En caso se estár aprobado)  
    ![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/gw1H19A07ofn7cv4-image.png)
    
      
    En caso que el pedido NO esté aprobado encontrarás los motivos en **Notas** **del Pedido** ademas ver más detalles sobre el pedido. Pago **Aprobado**, **Rechazado** o **Reembolsado**    
    <p class="callout danger">**CANCELADO POR EL USUARIO**</p>
    
    ![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/nqALWvBEgm0B6X9x-image.png)
    
      
    <p class="callout danger">**CANCELADO POR FALTA DE PAGO**</p>
    
      
    ![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/MY7XBXTI7R9DnC1J-image.png)
    
      
    <p class="callout success">**PAGO APROBADO**</p>
    
      
    ![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/PmflbJgQaARNOV3V-image.png)
    
    <p class="callout success">**PAGO REEMBOLSADO**</p>
    
    ![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/qr874KhgLEOIpQ9p-image.png)

# Preguntas Frecuentes

**¿Por qué no aparece Go Cuotas en los Métodos de Pago?** Esto posiblemente puede ser porque la moneda de tu tienda no está configurada en **Pesos Argentinos** o también puede ser por **Credenciales Inválidas.**

**¿Qué necesitan mis clientes para abonar con Go Cuotas?** Tus clientes van a requerir una cuenta en **Go Cuotas** y tener asociada una **Tarjeta de Débito.**

**¿Por qué veo pedidos cancelados con el mensaje "Cancelado por Falta de Pago / Pago Expirado"?** Esto se produce cuando los clientes generan un pago pero nunca lo completa. Pasado 30 minutos **Magento / Go Cuotas** procesan la cancelación de los pedidos.

**¿Puedo dejar de ofrecer Go Cuotas como método de pago?** Porsupuesto, en caso que desees ocultar **Go Cuotas** de lo métodos de pago solo deberás desactivar el método desde **MageRocket** &gt; **Go Cuotas** &gt; **Configuration** &gt; **Enable** = **No** ó **Stores** &gt; **Configuration** &gt; **Sales** &gt; **Payment Methods**

# Desinstalación

Para desinstalar completamente el modulo deberas ejecutar el siguiente comando

```bash
bin/magento module_uninstall MageRocket_GoCuotas
```

<p class="callout warning">**¡ATENCIÓN!** Desactivar el módulo causará perdidas de datos. Realizar dicha acción bajo su propia responsabilidad.  
</p>

El comando desintalará el módulo y sus dependencias (MageRocket\_Core) en caso de que no sea utilizado por otro modulo.

# English

Go Cuotas Guide - Translation in progress

# Introduction

**Go Cuotas** allows your customers to pay in **INSTALLMENTS** without interest with **debit cards**. Provide your customers with a hassle-free shopping experience with **Go Cuotas**.

![Browser.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/E0QaA2w2kfim061b-browser.png)

# Installation

#### Requirements

- **PHP**: &gt;= 7.4
- **Magento 2**: 2.3.x (2.3.3 / 2.3.6) - **2.4.x**
- [Go Cuotas Account](https://u.magerocket.com/9d9fbc)

<p class="callout warning">**IMPORTANT**: The store currency must be set to **Argentine Pesos (ARS)** <span style="text-decoration: underline;">otherwise the payment method will not be available</span></p>

#### Installation

To install Go Cuotas in your store, follow these steps:

1\. Run the following command: **Magento &gt;= 2.4.x**

```
composer require magerocket/module-gocuotas
```

<p class="callout info">For Magento **2.3.3 / 2.3.6** install next packages</p>

```
composer require magerocket/module-gocuotas-m23
composer require magerocket/module-core-m23
```

2\. Enable the module by running:

```
php bin/magento module:enable MageRocket_GoCuotas MageRocket_Core
```

3\. Run setup upgrade:

```
bin/magento setup:upgrade
```

That's it! Now you're ready to proceed with the **Module Configuration**.

# Configurations

**1)** Position yourself over the **MageRocket** icon, click, and then click on Settings.

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/BX8EUorwJExkB6Bb-image.png)

<p class="callout info">In case the menu doesn't appear, you can access it from **Stores** &gt; **Configuration** &gt; **Sales** &gt; **Payment Methods**.</p>

 **2)** Now we need to find the **Go Cuotas** payment method and click on **Configure**.

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/AjjFXIxm5ehZese5-image.png)

**3)** Once the button is clicked, all available configurations will be displayed.

The first thing we need to do is configure the **Credentials**, **Payment Method** (Redirect or Modal) and **Environment** (Testing or Production).

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-04/scaled-1680-/c9TsuV2VCkqRnclS-image.png)

- **Enable**: Determines if the payment method is available.
- **Integration Mode**: Determines if the module operates in Testing or Production mode.
- **Payment Description**: Allows you to modify the description that the customer will see at checkout.
- **Payment Method**: Modal or Redirection. Determines whether a modal will open to complete the payment or if the customer will be redirected to the Go Cuotas site to make the payment.
- **Checkout Position**: Allows defining the position of the payment method in the checkout.
    
    <div class="w-full pt-2 md:pt-0 dark:border-white/20 md:border-transparent md:dark:border-transparent md:w-[calc(100%-.5rem)]"><form class="stretch mx-2 flex flex-row gap-3 last:mb-2 md:mx-4 md:last:mb-6 lg:mx-auto lg:max-w-2xl xl:max-w-3xl"></form>  
    </div>
    
    
    #### **Credentials Configuration**
    
    [![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/9ejLeww2ZJjXx8sa-image.png)](https://docs.magerocket.com/uploads/images/gallery/2023-12/9i8zgi6seJuxpVpy-image.png)
- **Production Credentials** / **Sandbox Credentials**: You must fill in the **Email** and **Password** provided by **Go Cuotas**.

<p class="callout info">**Remember** that each environment has its own credentials.</p>


####  **Order Configuration**

From here, you can configure the states for orders with **Approved Payment** and **Payments Rejected** or **Canceled by the User**.

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/2ds8OqXCBtN3ehQN-image.png)

- **Status for Approved Orders:** It will display all states associated with the **Status Processing.** Default Value: **Processing**.
- **Status for Rejeced Orders:** It will display all states associated with the **Status Canceled.** Default Value: **Canceled**


#### **Cron Configuration <span style="color: rgb(224, 62, 45);"><sup>(GoCuotas v1.0.4)</sup></span>**

Starting from **version 1.0.4**, it is now possible to customize the waiting time before Magento automatically cancels an order due to non-payment.  
The waiting time can be configured **starting from a minimum of 30 minutes** (default value). If you decide to increase this time, it must always be expressed in minutes.

[![Cron Group](https://docs.magerocket.com/uploads/images/gallery/2024-11/scaled-1680-/7OiKeiiO14EhkN6h-cron-group.jpeg)](https://docs.magerocket.com/uploads/images/gallery/2024-11/7OiKeiiO14EhkN6h-cron-group.jpeg)

####  **Refunds Configuration**

This section allows you to enable **Refunds** and configure the maximum number of days within which a refund can be generated.

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/IaoUnGtFFLLVwxjF-image.png)

- **Enable Refunds:** Allows enabling/disabling Returns.
- **Maximum amount of days until refund is not accepted:** After the configured number of days, it will not be possible to refund the payment.

<p class="callout warning align-left">**IT IS POSSIBLE TO MAKE A SINGLE TOTAL OR PARTIAL REFUND.**</p>

#### **Widgets Configuration**

From here, you will be able to **enable**/**disable** and customize the **Widget** displayed on the **Product Page.** If you need to modify the text of the widget and maintain the <span style="text-decoration: underline;">installment number</span> and <span style="text-decoration: underline;">amounts</span>, you should use **%1** and **%2** respectively wherever you want to display them.

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/HFHtT0neAH76L3jG-image.png)


####  **Checkout Configuration**

From here, you can modify options for the **Payment Method** at checkout.

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/DsEVmSD3M0zbfNPj-image.png)

- **Show Banner in Checkout**: Show/Hide banner.
- **Customize Banner**: Allows replacing the banner with a custom one.
- **Modal Instructions**: Modify the message the customer sees when paying with the Modal method.
- **Redirect Instructions**: Message the customer sees when paying with the Redirect method.

#### **Others Configurations**

Here you will find rare configurations

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-04/scaled-1680-/p8hG2Fr9rdCQLT1C-image.png)

- **Debug Mode:** Allows you to activate/deactivate extended reports.
- **Secret:** Unique signature to authenticate **Go Cuotas** notifications.

<details id="bkmrk-since-v1.0.3-regener"><summary>Go Cuotas v1.0.3</summary>

- **REGENERATE SECRET:** Allows you to regenerate the Secret

</details><p class="callout danger">**Under no circumstances should the Secret be modified. Doing so will result in the cancellation of pending orders.**</p>

# Order Flow

1. You should go to **Sales** &gt; **Orders**. Open an order paid with **Go Cuotas**.
2. Now, navigate to **Payment and Shipping Method**.
3. In the **Payment &amp; Shipping Method** section, you will find quick information about payment (if approved)  
    ![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/gw1H19A07ofn7cv4-image.png)  
    In case the order is <span style="text-decoration: underline;">NOT</span> approved, you will find the reasons in the Order Notes, along with more details about the order. Payment **Approved**, **Rejected**, or **Refunded**.

<p class="callout danger">**CANCELED BY THE USER**</p>

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/nqALWvBEgm0B6X9x-image.png)

<p class="callout danger">**CANCELED DUE TO NON-PAYMENT**</p>

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/MY7XBXTI7R9DnC1J-image.png)

<p class="callout success">**PAYMENT APPROVED**</p>

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/PmflbJgQaARNOV3V-image.png)

<p class="callout success">**PAYMENT REFUND**</p>

![image.png](https://docs.magerocket.com/uploads/images/gallery/2024-02/scaled-1680-/qr874KhgLEOIpQ9p-image.png)

# Frequently Asked Questions

**Why doesn't Go Cuotas appear in the Payment Methods?** This may be because your store's currency is not configured in **Argentine Pesos**, or it could also be due to **Invalid Credentials.**

**What do my customers need to pay with Go Cuotas?** Your customers will need an account with **Go Cuotas** and an associated **Debit Card.**

**Why do I see canceled orders with the message 'Order canceled. Payment expiration time'?** This occurs when customers initiate a payment but never complete it. After 30 minutes, **Magento** / **Go Cuotas** processes the cancellation of orders.

**Can I stop offering Go Cuotas as a payment method?** Certainly, if you wish to hide **Go Cuotas** from the payment methods, you just need to deactivate the method from **MageRocket** &gt; **Go Cuotas** &gt; **Configuration** &gt; **Enable** = **No** or **Stores** &gt; **Configuration** &gt; **Sales** &gt; **Payment Methods**.

# Uninstall

To completely uninstall the module, you must execute the following command:

```bash
bin/magento module_uninstall MageRocket_GoCuotas
```

<p class="callout warning">**WARNING!** Deactivating the module will result in data loss. Take this action at your own risk.</p>

The command will uninstall the module and its dependencies (MageRocket\_Core) if it is not being used by another module.