Prestashop (en) - kueski-dev/Dev-Center GitHub Wiki

Kueski Pay is a payment method where you have the option to buy now and pay later in convenient biweekly installments, without the need to have a credit card.

To offer Kueski Pay in your store, you need to install its module, and this guide will show you how.

[!IMPORTANT] Please note that to use Kueski Pay as a payment method, you must be registered as Kueski Pay Merchant. If you haven't done so yet, click on this link.

Before You Start

The requirements to install the Kueski Pay payment method in PrestaShop are as follows:

  • Download the Kueski Pay module from the PrestaShop Marketplace. You can do this derectly by clicking on this link

[!TIP] Keep your API KEY and API SECRET provided by the Kueski team handy, as they will be requested during the Configure Kueski Pay module section.

Install the Kueski Pay Module

The following steps are necessary to install the Kueski Pay module on your PrestaShop platform and start using its payment method:

  1. Log in to your PrestaShop dashboard.

  2. In the left-hand menu, follow this path Modules -> Module Manager.

  3. Click the Upload a Module button. A modal will open to select the file.

    Example of step 3

  4. Select the_Kueski Pay_ module file. The installation will start automatically.

[!IMPORTANT] The file you upload must be in .zip format. If the file was unzipped when downloaded, it must be compressed again before uploading it to PrestaShop.

:white_check_mark: The Kueski Pay module is now installed.

Configure the Kueski Pay Module

Once the module is installed, the next step is to configure Kueski Pay.

  1. Click the Configure button.

    Example of step 1

  2. Provide the conciliation URL in the Notifications field to your Kueski staff who provided this installation guide.

    Example of step 2

[!CAUTION] It is necessary that Kueski has your conciliation URL, as it is required for the correct functioning of the payment method.

  1. Fill in the fields with the following information:

    • API KEY: {{API KEY}}

    • API SECRET: {{API SECRET}}

    • Activate Sandbox: No

    • Order Accepted Status: Payment Accepted

    • Order error or Invalid Payment Status: Payment Error

    • Activate Log: Yes

      This toggle needs to be active. It allows viewing logs in case of an error

      Example of step 3

  2. Click the Save changes button located at the bottom.

:tada: The Kueski Pay module is now configured and ready to use.

Configure the Kueski Pay Widget

The following steps are necessary to configre the Kueski Pay widget on the PrestaShop platform.

[!NOTE] The Kueski Pay widget will automatically be visible after completing the steps in the Configure the Kueski Pay Module on the product page, shopping cart and checkout.

  1. Access the configuration of the Kueski Pay module in PrestaShop:

    • Log in to your PrestaShop dashboard.
    • In the left-hand menu, follow this path: Modules -> Module Manager -> Payment.
    • Click the Configure button in the Kueski Pay section.
  2. Fill in the fields with the following infomation:

    • Widget Color: Black

    • Widget Color in cart: Black

    • Widget color in checkout: Black

      If your store's theme is black, you should select White in all three fields.

    • Widget font size: 12px

      This option is for defining the text size of the Kueski Pay widget, you can choose between 12px, 14px and 16px. The default value is 12px

    • Text alignment: Left

      This option is for defining the text alignment of the Kueski Pay widget, you can choose between Left and Right. The default value is Left

      Example of step 2

  3. Click the Save changes button located at the bottom.

The Kueski Pay widget is now visible with the selected configuration.