Cash Developer Portal
Crear cuenta

Support

Whatsapp
      
        Home
      HOLA.CASH API
        Quickstart
        API Reference
        Error codes
        Testing cards
        Sample code
      CHECKOUT WIDGET
        Quickstart
        Sample code
      E-COMMERCE PLUGINS
        Magento
        Woocommerce
      Ayuda
        Tutorials
        FAQs
      
        Contact sales




Magento plugin

Installation

  1. Clean Magento Cache
    1. Open *System > Cache Management.
    2. Click on the button Flush Magento Cache.
  2. Reindexing
    1. Open System > Index Management.
    2. Select all the Indexer
    3. Select Update by Schedule and then Submit
  3. Unpack the holacash.zip file. (This is provided by your Account Manager)
  4. Connect to the server where the website source folder is located with FTP/SFTP client.
  5. Upload the hola.cash module in the directory app/code/.
  6. Go to Magento 2 root directory.
  7. Run below-listed commands :
    1. php bin/magento setup:upgrade
    2. php bin/magento setup:static-content:deploy -f
    3. php bin/magento cache:clean
  8. The installation of the plugin is complete

Configuration on hola.cash

  1. Login in the hola.cash portal with your credentials.
  2. Magento # 1
  3. Your APIs keys, both Public and Private, are in the Developer menu, you will need them later on.
  4. Magento # 2
  5. WarningCreate a Webhook, this should be pointing to the webhook URL in your Magento Store
  6. Magento # 3
  7. From the menu select Configuration, in Payment Methods select the payment methods that you want to use for your Magento Store
  8. Magento # 4
  9. Select the Personalization menu for the following setups:
    1. WarningAdd the URL from your Magento Store, this is a really important step, the plugin will be associated with that URL and is not going to be loaded from any other one.
    2. Magento # 5
    3. Widget view mode, select Inline, this is the only view mode for Magento Stores, if you select any other view mode, you may find visualization issues while loading the widget in your store.
    4. Magento # 5
    5. Enable or disable the Auto Capture of the payment as you need, for example, if you need to manually check all the payments in the store, then disable this option, for every transaction you will need to capture the amount. Enable the Auto Capture, especially for stores with a high volume of transactions.
    6. Magento # 5

Configuration on Magento

  1. Login in to your store with your credentials.
  2. From the menu, select stores and then configuration
  3. Magento # 2
  4. Select Sales and then select the Payment Methods sub menu
  5. Magento # 3
  6. Navigate to the Hola Cash Payment Section
  7. Magento # 4
  8. In the Hola Cash Payment Section there are several configuration options that are described below:
    1. Enables: If yes, the Hola Cash plugin will appear in the payment methods on the checkout in your store.
    2. Mode: Select between Production or Sandbox, In the sandbox mode transactions are processed in the hola.cash sandbox environment. These are test transactions and there is no actual money movement. Use the sandbox mode to test your integration. Set to Production mode to accept actual payments from your customers.
    3. Title: Here you can set how the hola.cash title will appear in the payment methods on the checkout in your store.
    4. Production/Sandbox API Key: Add your Public API Key
    5. Production/Sandbox Secret Key: Enter your API Secret key, remember that you should never share this key.
    6. Production/Sandbox Webhook Key:Add your associate Webhook key, for more info check our webhooks tutorial.
    7. Sort Order: This is the place where the plugin will be loaded if you have more than one active payment method.
  9. Sending extra parameters
  10. You can add extra custom parameters to the order, this can be handy pass information related to the order to Hola Cash. Sending these parameters is optional.

    Add an extra hidden field to the checkout form:

    <input type="hidden" name="charge_additional_details" value='[{"name": "test_int","data": "1"},{"name": "test_float","data": 3.45},{ "name": "test_boolean","data": false},{"name": "test_string","data": "string"}]' />