Install GrailPay Payment Gateway

    Last updated on November 22, 2022

    To offer your customers the benefit of paying with GrailPay, you must first sign up for a GrailPay Merchant Account and gain access to the GrailPay Merchant Dashboard.

    Important: GrailPay support only USD as base current and allow to paying in USA only.

    Installation

    Choose one of the installation methods described below.

    => Installation via composer

    This is the recommended installation method. Make sure you are familiar with Magento Composer workflow and everything is set correctly for the project.

    More information on Magento Composer.

    1. Connect with SSH of your hosting and go to the root path of the Magento installation directory.

    2. Run this command to install module:

      composer require GrailPay/GrailPay-magento


      If you would like to install s specific version of Magento extension, use this command

      composer require GrailPay/GrailPay-magento:x.x.x

      You can get versions of extension from Magento Marketplace

    3. Now, we need to run commands related to bin/magento. Make sure, you have permission to execute bin/magento commands.

      php bin/magento setup:upgrade
      php bin/magento cache:flush
      php bin/magento cache:clean


      In production mode, you should have to run these commands also for the compile and deploy module’s static files.

      php bin/magento setup:di:compile
      php bin/magento setup:static-content:deploy
      php bin/magento cache:flush
      php bin/magento cache:clean

    If you are using composer first time, or if any error you see related to composer: Make sure, you have correctly saved authentication keys within the composer installation. Otherwise, you can follow these instructions.

    => Installation manually

    1. Download the module from our github channel.

    2. Go to directory <path_to_the_store_root_directory>/app/code/Magento
      If the directory does not exist in Magento source, you have to create it with case-sensitive structure.

    3. Extract the module manually or you can use these commands to extract the directory:
      If the module is zip format, use this command

      unzip GrailPay-magento.zip


      if the module is tar format, use this command

      tar -xvf GrailPay-magento.tgz

       

    4. Now, we need to run commands related to bin/magento. Make sure, you have permission to execute bin/magento commands.

      php bin/magento setup:upgrade
      php bin/magento cache:flush
      php bin/magento cache:clean


      In production mode, you should have to run these commands also for the compile and deploy module’s static files.

      php bin/magento setup:di:compile
      php bin/magento setup:static-content:deploy
      php bin/magento cache:flush
      php bin/magento cache:clean

    Configure Extension

    1. You need authentication keys from GrailPay, and will use authenticate extension in magento.

    2. You will get two mode of authentication keys from GrailPay:
      A. Sandbox Authentication Key
      B. Production Authentication Key

    3. Login to your eCommerce Admin Panel. Make sure, you will have all permission to configure GrailPay extension in magento.
      Navigate to Stores > Configuration > Sales > Payment Methods

       

    4. Under Enabled, select Yes

    5. Paste the authentication key into Authentication Token into GrailPay extension.

    6. Other fields has use for extra configuration:
      A. Sandbox Mode, choose Yes to enable sandbox mode. Make sure you have paste authentication key of sandbox mode, otherwise extension will give error on process of checkout with GrailPay.
      B. Debug Mode, choose Yes to enable debug mode.
      C. Sort order, enter number of weight or position for display payment extension.

    7. After enter details into GrailPay extension fields, save the configuration by Save Config button in top.

    8. Save and flush the cache after setup.