- From the menu, select Plugins and then click on the Add New
- Upload the holacash.zip file. (This is provided by your Account Manager)
- The installation of the plugin is complete
Configuration on hola.cash
- Login in the hola.cash portal with your credentials.
- Your APIs keys, both Public and Private, are in the Developer menu, you will need them later on.
- Create a Webhook, this should be pointing to the webhook URL in your WooCommerce Store
- From the menu select Configuration, in Payment Methods select the payment methods that you want to use for your WooCommerce Store
- Select the Personalization menu for the following setups:
- Add the URL from your WooCommerce 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.
- Widget view mode, select Inline, this is the only view mode for WooCommerce Stores, if you select any other view mode, you may find visualization issues while loading the widget in your store.
- 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.
Configuration on WooComerce
- From the WooCommerce menu select Settings
- Look for the hola.cash section and click on the Manage button
- In the hola.cash plugin are several options to configure the plugin
- Enables: Mark the check box to enable the use of the hola.cash plugin, it will appear in the payment methods section of your store.
- Sandbox: This will enable the Sandbox environment, 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. Disable Sandbox mode to accept actual payments from your customers.
- Title: Here you can set how the hola.cash title will appear in the payment methods on the checkout in your store.
- Production/Sandbox API Key: Add your Public API Key
- Production/Sandbox Secret Key: Enter your API Secret key, remember that you should never share this key.
- Production/Sandbox Webhook Key:Add your associate Webhook key, for more info check our webhooks tutorial.
- Debug: Use this setting to log the events to the console.
Sending extra parameters
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. Also, if the $modified_additonal_data returned is not a valid associative array, then the data will be ignored and not sent to the API.
- On the server-side in the functions.php add the following code:
* Returns modified additional data array
* @param - $additional_data - current additional data array
* @return - $modified_additional_data - Modified additional data array
// example data
Make sure the function holacashwc_add_charge_additional_details returns an associative array of all the additional metadata you want to send to hola.cash.