beanstream

 

Description

This screen enables you to edit the payment method options. Payment methods will be filtered on checkout based on the zone you set for them, if any. Then, they will be displayed to the user for him to choose which payment method he prefers for his order.

Note that the payment method can probably support only a limited number of currencies.

 

Toolbar

 

  • Save & Close : Save the payment method options and return to the payment methods Management screen.
  • Save : Apply the modifications to the payment method and stay on the same screen.
  • Cancel : Return to the previous screen without saving the modifications.
  • Help : This button enables you to turn ON/OFF the help section, this screen will appear or disappear.

 

Main Information

If you use one of our commercial versions, you will be able to enter the name and description in different languages. This feature requires to have joomfish installed and can be activated in the configuration page, in the display tab. The languages available will be the ones in joomfish. If you don't enter something for a translation, it will just use the default information in the Main information tab instead. After you click on save or apply an additional publish icon will appear next to the fields where you entered something in the languages tabs so that you can easily enable or disable them. The default publish status can also be changed in the configuration page of HikaShop.

 

Generic information

 

  • Published : This option allows you to publish or not the payment method.
  • Images : Select here the desired images to be displayed for this payment method. If you want to add additional images, you can upload them via FTP into the folder media/com_hikashop/images/payment/ of your website and you will then be able to select them in that option.
  • Price : You can set the payment fee in this field, and select the currency of the fee.
  • Percentage : The percentage allows you to define a payment fee depending on the total amount of the products in the cart.

 

beanstream

Beanstream Settings

This plugin requires an account on the Beanstream platform. With your account information, you first need to log in the Beanstream system on: https://www.beanstream.com/admin/sDefault.asp?
Once you’re logged, you’re able to manage your account setting, and thus your website’s transactions. The left panel allows you to configure your entire account.
On administration > account > transaction filtering, you can restrict the transactions accepted by Beanstream ; just add your website IP (a rapid search on www.who.is will give you your IP) on the field Accepted IP. If you don’t want to put any restriction on the transactions requests, just check the box Allow Transaction requests from any IP address […]

 

Then, on administration > account > order setting, you’ll be able to add some additional security settings.
The Hikashop plugin only supports the hash validation, which is highly recommended to activate.
First, on the Transaction Validation Options part, select one (or both, recommended) of the two hashes checkbox options (all Payment Gateway transaction requests or Transaction Response Page redirection).Then, generate your personal hash key :

  1. Pick a word of your choice
  2. Hash it on MD5 or SHA-1 (your choice, it doesn’t matter) with any website (a quick Google search will return a list of many free MD5 or SHA-1 hash generator tools. For example: http://www.stringfunction.com/)
  3. Enter the string generated on the Hash key field
  4. Pick the Hash Algorithm you chose to encrypt

 

 

Still on administration > account > order setting, complete the field Payment Gateway of Response Notification with the URL indicated on your plugin’s configuration (Hikashop backend, see next part), which might be something like http://xxxxxx.com/beanstream_params.php

 

 

Do not activate any of the other security settings, the plugin doesn’t support them. 
You’ll find more information about your account configuration on the Beanstream documentation: https://beanstreamsupport.pbworks.com/f/BEAN_Quickstart.pdf

 

Hikashop settings

Once your Beanstream plugin is installed and published, you have to edit it (from Hiakshop panel, System > Payment methods > Beanstream) to make sure it works.

 

 

·         Payment method: You have to select the currency associated to your account. You must have one Beanstream gateway merchant ID and administrator account for each processing currency. You can see your account currency at the top of your account settings page.

·         Merchant number: Enter here your merchant number. You can see your account currency at the top of your account settings page.

·         Hash method: The hash method you had selected on your account (see previous part). If you didn’t have selected any, just select “None”.

·         Hash: The hash you had created on your account (see previous part). Leave the field empty if you didn’t have any hash method.

·         URL: The URL you have to enter in your account settings, on administration > account > order setting > Payment Gateway (see previous part).

·         Debug: You can activate the debug mode of the Beanstream payment plugin. If you do so, information about each notification received from Beanstream will be logged in the payment log file. You can see and modify the location of this file in the configuration page of HikaShop.

·         Invalid status: Here, you can select the status to set to an order if the plugin receives a notification from Beanstream for an order with an amount different from the order total or in a different currency. In that case, we highly recommend you to check your Beanstream account, the order information, and maybe contact your customer, and decide yourself what to do with the order.

·         Verified status: Here, you can select the status to set to an order if the plugin receives a successful completion notification from Beanstream for an order.

 

 

Restrictions

  • Zone : You can restrict the check payment method to a zone. By clicking on the edit icon, a popup will open enabling you to select a zone. You can also remove this limitation by clicking on the delete icon.
  • Shipping method : With this option you can select the shipping method for which this payment method will be available. For example, if you choose UPS, this payment method will only be usable if UPS is selected as shipping method. If an other shipping method is selected, this payment method will not be displayed. Note: if you selected "None" or don't select any shipping method, this payment method will always be available.
  • Currency: Choose the currencies allowed by this payment method.
  • Minimum price : The payment method can be available for only orders above a minimum price. This price uses the payment method price currency even if the price is 0.
  • Maximum price : The payment method can be available for only orders below a maximum price. This price uses the payment method price currency even if the price is 0.
  • With tax : Display the payment method only for products with tax.
  • Minimum quantity : If the order has a price lower than the price set in this field, so this payment method will not be available.
  • Maximum quantity : If the order has a price upper than the price set in this field, so this payment method will not be available.
  • Minimum weight : You can set a minimum weight so that orders below it won't be able to be paid with the current payment method. The weight of the order will be calculated based on the weight of each products in it.
  • Maximum weight : You can set a maximum weight so that orders over it won't be able to be paid with the current payment method. The weight of the order will be calculated based on the weight of each products in it.
  • Minimum volume : You can set a minimum volume so that orders below it won't be able to be paid with the current payment method. The volume of the order will be calculated based on the volume of each products in it. The volume is calculated with the width, height and length of the products.
  • Maximum volume : If the order has a volume upper than the price set in this field, so this payment method will not be available.
  • Prefix : You can restrict your payment methods to only post codes including such prefix with this option.
  • Minimum post code : You can restrict your payment methods to only post codes within a certain range whereby this is the minimum possible value
  • Maximum post code : You can restrict your payment methods to only post codes within a certain range whereby this is the maximum possible value
  • Suffix : You can restrict your payment methods to only post codes including such suffix with this option.

 

Access level

 

The ACLs are available in the business edition of HikaShop.  

  • None : When "none" is selected, the payment method will never be displayed.
  • All : "All" allow you to display the payment method for all the type of users. All groups are allowed to pay via this payment method.
  • Custom : Here you can select which groups can use this payment method. All the checked groups will be able to use this method.