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