View source for X-Cart:FedEx Cross Border (formerly Bongo International)

{{XC version|version=4.4.5|color=#FFB62F|comment={{{1|or above}}}}}


== Overview ==

'''FedEx Cross Border (formerly Bongo International)''' is a comprehensive global eCommerce solution provider designed to enable US-based merchants to reach international consumers. Bongo facilitates global expansion while offering fraud protection to businesses interested in converting international shoppers and driving new revenue.

* '''Bongo Extend''' is a powerful shopping cart plug-in that enables international shoppers to obtain EU and US shipping addresses and make purchases from your eCommerce store immediately.
Extend’s innovative and portable technology allows businesses to participate in global eCommerce without the complications of developing resources for handling global logistics. <br />
{{Note1|Bongo Extend is being phased out by Bongo International and is no longer available to new clients. For more info, see https://bongous.com/extend-further-upgrade-to-checkout/}}

* '''Bongo Checkout''' is a modular eCommerce solution that promotes safe acceptance of international eCommerce orders with guaranteed fraud protection.
Checkout is an integrated and secure international eCommerce solution that pairs well with most eCommerce infrastructures. Additionally, Checkout is EAR compliant, and screens against the CCL and the required Denied Party Lists, so you don’t have to.
Checkout also ensures compliance with all prohibitive licensing agreements, while allowing consumers to purchase approved items from your business.

X-Cart provides a module that enables '''FedEx Cross Border (formerly Bongo International)''' in your store.

== System requirements ==

To be able to use the Bongo International module, you need the following components installed and configured on your system:
:* X-Cart 4.4.5 or later (If you do not remember the version of X-Cart on which your store is based, you can look it up in the <u>Environment info</u> section of the [[X-Cart:Summary_Page |Summary]] page in X-Cart Admin area);

You will find that the Bongo International module archive contains a script "bongo_international.php". After installing the module, you don't need to set it up. It's optional.

== Installation of Bongo International module ==

To install the Bongo International module:

# Obtain a distribution package for the Bongo International module by downloading it from the File Area section of your {{QA}}. The distribution package you need is contained in the archive file <u>bongo_international-x.y.z.tgz</u> or <u>bongo_international-x.y.z.zip</u> where <u>x</u>, <u>y</u> and <u>z</u> are the version numbers of the module. Make sure the version of the module is the same as the version of the installed X-Cart.
# Copy the contents of the module archive for your specific X-Cart version to the X-Cart root directory on your server or hosting account.
#* If you are using a Windows-based server, or a UNIX-based server without terminal access:
#: a) Unpack the module archive to a directory on your system using your favorite compression program (WinZIP, 7-Zip or any other archiver with support for TAR files).
#: b) Use an FTP client to upload all the files contained in this directory (retaining the directory structure) to the X-Cart root directory on your server or your hosting account.
#* If you are using a UNIX-based server with terminal access:
#: a) Use an FTP client to upload the module archive to the X-Cart root directory on your server or your hosting account.
#: b) Unpack the archive using the following command:
#: <pre>tar -xzvf bongo_international-x.y.z.tgz</pre>
#: (Replace <u>x</u>, <u>y</u> and <u>z</u> with the actual version numbers).
#: {{Note1|'''Important:''' Make sure you keep the directory structure while unpacking and uploading the module archive, otherwise some necessary files may be overwritten!}}
# In a web browser, run the installation script <u>http://YOUR_XCART_DOMAIN/install-bongo_international.php</u> replacing <u>YOUR_XCART_DOMAIN</u> with the actual domain name of your X-Cart store. This will start the installation wizard. A screen like the following will be displayed:<br />[[File:Bongo_International_Installation_Wizard_1.png|700px|border]]<br /><br />
# Carefully read the License agreement, enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box:<br />[[File:Bongo_International_Installation_Wizard_2.png|700px|border]]<br /><br />
# Click '''Next''' to continue. The installation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be activated:<br />[[File:Bongo_International_Installation_Wizard_3.png|700px|border]]<br /><br />{{Note1|'''Note:''' If you are using a custom skin, you will need to patch it manually. Otherwise, the module will not work in this skin.}}
# Once the process is completed, click '''Next'''. This will open the next screen where you will be asked whether you wish a new system fingerprint to be generated:<br />[[File:Bongo_International_Installation_Wizard_4.png|700px|border]]<br /><br />
# Make your selection (Yes/No) and click '''Next'''. If you have chosen to generate a new system fingerprint, it will be generated. The process of generating a system fingerprint may take up as long as a few minutes. Once the generation process is completed, click '''Next'''. If you have chosen to skip the generation of a system fingerprint, you will be taken to the next step.
# After clicking '''Next''' you should see the "Installation complete" screen:<br />[[File:Bongo_Installation_Complete.png|700px|border]]<br /><br />This is the final step. It informs you that the module has been installed successfully. It also reminds you to remove the module archive file in case you put it in a web accessible directory; this is needed to protect the module from unauthorized copying.<br />'''Important:''' At the final step of the installation process, the installation script <u>install-bongo_international.php</u> is automatically renamed as an additional measure to protect the module installation. Please take note of the file name to which the installation script was renamed. If you decide to re-install or uninstall the module later on, you will need to rename the installation script back to <u>install-bongo_international.php</u> before launching the installation process in your web browser.<br /><br />Now if you choose to view the list of your store's installed modules (this can be done using the Administrator area link provided on the "Installation complete" screen), the Bongo International module will be on the list:<br /><br />[[File:Bongo_Module_enable.png|700px|border]]<br /><br />Note that after the module has been installed, it is already in the enabled (active) state. You can temporarily disable the module using the module deactivation instructions.

== Uninstallation of Bongo International module ==

Uninstallation completely removes all the data related to the Bongo International module from your store.

To complete the uninstallation, you will need to run the Bongo International module installation script. You might remember that, after the module was installed in your store, the script was saved with a new name to help prevent unauthorised runs of the installer. Now, before you start, you need to rename the script back to its original name - <u>install-bongo_international.php</u>.

'''To uninstall the module''':

# Run the module installation script in your web browser by going to <u>httр://<YOUR_XCART_DOMAIN>/install-bongo_international.php</u> (be sure to replace the <u><YOUR_XCART_DOMAIN></u> part with the actual domain name of your X-Cart store). This will start the installation wizard. A screen like the following will be displayed:<br />[[File:Bongo_International_Installation_Wizard_7.png|700px|border]]<br /><br />
# Select "Uninstall the module", enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]] for your X-Cart installation into the Auth code field and select the "I accept the License Agreement" check box:<br />[[File:Bongo_International_Installation_Wizard_8.png|700px|border]]<br /><br />
# Click '''Next''' to continue. The uninstallation process will start. The installer will make the necessary changes to your X-Cart installation, and the module will be deactivated.
# Once the process is completed, click '''Next'''. This will open the next screen where you will be able to generate a new system fingerprint.
# Generate the system fingerprint (or skip it). After clicking '''Next''' you should see the "Uninstallation complete" screen.<br /><br />This is all. The Bongo International module has been uninstalled.

== Activating and deactivating the module ==

It is possible to temporarily disable (deactivate) the installed Bongo International module. Deactivation stops the module from operation, but it does not remove any settings you made to the module configuration nor clear any data that was generated during the period that the module was in operation. If you wish to completely remove all the data related to using the module, you need to uninstall it.

'''To disable the module''':

# Go to the Modules section of your store's Admin area (Settings menu->Modules).
# Locate the entry for the Bongo International module and unselect the respective check box on the left.
# Depending on the version of X-Cart you are using, you may need to apply the change by clicking the '''Apply changes''' button. The module will be disabled.

If the Bongo International module is installed, but not active, you can enable (activate) it.

'''To enable the module''':

# Go to the Modules section of your store's Admin area (Settings menu->Modules). This opens the list of your store's installed modules.
# Locate the entry for the Bongo International module and select the respective check box on the left.
# Depending on the version of X-Cart you are using, you may need to apply the change by clicking the '''Apply changes''' button. The module will be enabled.

== Configuring the module ==

After the module has been installed and enabled, it needs to be configured.

'''To configure the module''':

# In the Modules section of your store's Admin area (Settings menu->Modules), locate the entry for Bongo International module and click the '''Configure''' link next to it:<br />[[File:Configure Bongo International.png|200|border]]<br /><br />The Bongo International module configuration page opens:<br />[[File:General_settings_Bongo_International.png|700px|border]]<br /><br />
# Adjust the module configuration settings:
#*'''<u>Bongo Extend</u>''' is a simplified integration. In this case, the default checkout is used; however, a special banner appears on the site. This banner informs of the possibility of international shipping providing a special address that should be used as a shipping address.<br />''<u>Extend JS code</u>'' is provided by Bongo in the process of integration.
#*'''<u>Bongo checkout</u>''' is a full integration with checkout on the Bongo end.<br />''<u>Partner key</u>'' is provided by Bongo in the process of integration.  <br />''<u>Checkout ID</u>'' is provided by Bongo in the process of integration.<br />''<u>Exclusion countries</u>'' is the list of countries that don't require the usage of Bongo Checkout. The country of the store location is always selected in this list. So, Bongo cannot be used for shipping in the same country.<br />''<u>Free Domestic Shipping</u>'' is selected in case of absence of free shipping to Bongo's office. If selected, it provides free shipping from a merchant to Bongo International Shipping Destination Postal Code (Zipcode of Bongo International office).<br />''<u>Currency conversion rate</u>'' is the price of a USD in the currency of the store (1 USD = X in the store currency)<br /><u>''Bongo checkout urls''</u> is the data that should be provided to Bongo in process of integration.<br /><u>''Export''</u> is an optional feature. It allows to pass the store products data to Bongo in case cron file is not set up or if the data should be passed to Bongo beyond the cron shedule.
# Click '''Apply changes'''.<br /> Now your module has been configured.

== Setting up the execution of periodic tasks for Bongo Checkout ==
The module Bongo International provides a script <u>bongo_international_cron.php</u> that must be run periodically for the correct operation of the module.

You can launch this script using your favorite scheduling program (for example, [http://en.wikipedia.org/wiki/Cron | cron daemon] in Unix/Linux systems). 

To run the script via crontab, use a command formatted like the following:
<pre>
cd /var/www/vhosts/yoursite.com/httpdocs/xcart; /usr/bin/php -d safe_mode=Off bongo_international_cron.php –key=c901d65fc15ff15d0ac0af967437d051
</pre>
(Be sure to replace the paths and the [[X-Cart:General_Options| secure key for launching the cron.php script]].)

Alternatively, it is possible to periodically run the script manually by going to a URL formed like the following:<br />
https://your_xcart_domain/xcart_dir/admin/configuration.php?option=Bongo_International <br />
(Be sure to modify the above URL to use the actual address of your X-Cart store)

== Adding Bongo shipping to a product ==

To add Bongo shipping to a product:

# In the products section (Catalog -> Products), find the product for which you wish to add Bongo shipping option. Click on the product name to open the '<u>Product Management</u>' page.
# In the '<u>Product Management</u>' section menu, click on the '''Bongo''' link.<br>[[Image:In this section Bongo.png|300px|border]]<br>The Bongo shipping settings page for this product opens.<br />[[Image:Product management Anna Karenina 2.png|700px|border]]
# In the opened page fill in the following fields:<br />''<u>Country of Origin</u>'' the country of product origin.<br />''<u>Harmonized System Code (HS Code)</u>'' see http://en.wikipedia.org/wiki/Harmonized_System<br />''<u>Export Control Classification Number (ECCN)</u>'' see http://en.wikipedia.org/wiki/Export_Control_Classification_Number<br />''<u>Hazardous product</u>'' select this checkbox if the product is hazardous (acid, gas, deflagrating mixture)<br />''<u>Countries that require a license for the product</u>''<br />''<u>Countries to which the product can not enter</u>'' <br />''<u>Product type</u>'' product type according to Bongo classification.<br /><br />Note, <u>Country of Origin</u> is a mandatory field, other fields are optional.<br /><br />
# Click '''Apply changes'''. Bongo shipping details are now set for the product. Shipping for this product will be done by Bongo International.

== Bongo Extend ==

With such integration, checkout is default, however now there is a Bongo banner on checkout displayed for customers.<br />[[Image:Checkout with bongo extend.png|700px|border]]<br /><br />Clicking on this banner opens a Bongo registration window. Your customers should use this window to register with Bongo and to get a shipping address. Shipping calculation is done directly between a customer and Bongo.<br />[[Image:Bongo banner checkout.png|400px|border]]

== Bongo Checkout ==

This is a full integration with Bongo, replacing the default checkout.<br />[[Image:Bongo international checkout.png|700px|border]]<br /><br />
#As soon as the data is entered into <u>Estimate Shipping cost</u> section, products are sent to Bongo and it returns their shipping cost and the list of products available for shipping.<br />[[Image:Estimated shipping bongo.png|700px|border]]<br /><br />If a product is not available for shipping or it's shipping to the destination country is restricted, shipping for this product won't be calculated and the product will be marked as "This item is not available for international shipping".<br />[[Image:bongo_shipping_restricted.png|700px|border]]<br /><br />
#A customer may continue checkout on Bongo side or on X-Cart side.
#*To get to Bongo checkout a customer should click a special button which is located under default checkout button.<br />[[Image:Bongo_button.png|200px|border]]<br />The customer will be redirected to Bongo side to continue checkout. After successful checkout a customer will be redirected back to X-Cart and will see a message that the order has been created.<br />
#*If a customer clicks X-Cart default '''Checkout''' button, he will be redirected to X-Cart checkout. If further he selects a country available for international shipping with Bongo, he will be redirected to Bongo side. Otherwise, he will continue checkout with X-Cart.<br />[[Image:Shopping_cart_4.png|700px|border]]<br /><br />
#After the order is successfully processed, the store administrator gets additional information related to orders created with Bongo International.<br />[[Image:Bongo order info.png|700px|border]]

[[Category:X-Cart modules]]