Amazon Payments Implementation Guide. Support for ZenCart

Transcription

1 Support for ZenCart This document explains the necessary steps to offer Amazon Payments on your website. You will need to create an Amazon Payments account and enter your Merchant ID and MWS access keys within the ZenCart admin area. 1. Register for an Amazon Payments account using the following link: Register for Amazon Payments We recommend using a separate login to your personal Amazon shopping account or Amazon Marketplace account (if you have one). Please have the following ready before you begin: Business information Business name, category, sales volume, company registration and ownership information. Place of establishment address. This must be in the United Kingdom, Germany or Luxembourg. VAT registration details if applicable Personal information for yourself as well as all business owners Full name Date and place of birth Country of citizenship Residential address Passport or National Identity card (to be entered later through Seller Central) In addition, you will need: A U.K. or internationally chargeable credit card with a valid billing address. A phone number where you can be reached during this registration process. 2. Verifying your account in Seller Central Once registered, you need to verify your account by logging into Seller Central: Using your and password created in step 1 Ensure you are in the payments.amazon.co.uk area using the dropdown box in the top left of the page. Navigate to Settings > Account Information or use the alert link from the home page. 1

2 2.1 Enter Passport details You will be required to enter passport or national ID information at this stage. Scroll down to Account Status Amazon Payments Europe and select the Edit button. Passport or national ID details will be required for all company owners who own more than 25% of the business. 2.2 Enter Bank Account details To enable funds transfer, you will need to add bank details in Seller Central. Within the Account information page, scroll down to Deposit Method and select Add. From the Global Bank Account Information page, please add: Bank Name, Sort Code & Account Number Bank Account holders Name 2.3 Additional information Your Amazon Payments account will then be submitted for review. During the review process it may be necessary to provide additional information such as recent utility bill or Articles of Association. Please ensure these documents are faxed as soon as possible to speed up the registration process to Finding your Merchant ID This step can be done while the account is pending business verification. 3.1 Select Settings > Checkout Pipeline Settings, provide merchant ID in your ZenCart backend (see step 5.3) 2

3 4. Creating your MWS access keys This step can be done while the account is pending business verification. 4.1 Select Integration > MWS Access Keys 4.2 Select access own Amazon Seller account with MWS and accept the Amazon MWS license. Here are the MWS access keys you should enter into your ZenCart backend (see step 5.3): 3

4 5. Installing the Zen Cart Checkout by Amazon module Please refer to the plugin s installation guide text files that come with the plugin for updated information. Also, please be advised that the plugin actually consists of two separate parts: the main module (called CBA) and the refund extension that depends on the CBA part (called REFUND) Installing main part Complete section for existing ZenCart configuration or section for a fresh install. Then continue with section Detailed information can also be found in the INSTALLATION_GUIDE_CBA.txt file included in the plugin s archive Installation to integrate Checkout by Amazon in an existing ZenCart configuration: To integrate Checkout by Amazon in an existing Zen Cart configuration, you will need add new files and modify some existing files within Zen Cart as described below: I. Copy the files from CBA/new_files directory to your ZENCART_DIR/ II. Modify the shopping cart template file: Search for the following code in line no : <div class= buttonrow back ><?php echo <a href= javascript:popupwindow(\. zen_href_link(filename_popup_shipping_estimator). \ ) >. zen_image_ button(button_image_shipping_estimator, BUTTON_SHIPPING_ESTIMATOR_ALT). </a> ;?></div><?php }?> Add the following Code after the above lines i.e. line no 158: <!-- ** BEGIN CHECKOUT BY AMAZON ** --> <?php // the button template displays CBA button if cart contents >0 and value >0 if (defined( MODULE_PAYMENT_CBA_STATUS ) && MODULE_PAYMENT_CBA_STATUS == True ) { include_once(dir_fs_catalog. checkout_by_amazon/includes/button. php );}?> <!-- ** END CHECKOUT BY AMAZON ** --> Note: Line no s may not be exactly the same as mentioned here. Please take extra care when adding the code and always backup your files before making any modifications. III. Now go to your Zen Cart Administration > Modules > Payment and select Checkout by Amazon and click on the install button to install the configuration settings Installation with a fresh installation I. Copy the files from the CBA/new_files directory to your ZENCART_DIR/ II. Copy the file CBA/modified_files/includes/templates/template_default/templates/tpl_shopping_cart_ default.php to ZENCART_DIR/includes/templates/template_default/templates/tpl_shopping_cart_ default. php. This will overwrite the existing file. 4

5 III. Now Sign in to your Zen Cart Administration > Modules > Payment and select Checkout by Amazon and click on the install button to install the configuration settings Configuring cron Job Please configure or ask your hosting provider to configure a cron job that can run once in 5 or 10 minutes. You can also use one of the many free cron job services on the internet. This cron job ensures that the orders and order statuses are synched up with Amazon on a regular basis. Please refer example below for a sample cron job configuration. IMPORTANT: If you want to manage orders placed through Checkout By Amazon on your website, setting up the cron job is mandatory. */5 * * * * wget -O / dev/null This cron is required to keep your orders in sync with Amazon Seller Central Order system. Note: Some Hosting provider will not allow you to set cron run once in 5 or 10 minutes. In such case, please contact hosting provider for appropriate configurations Installing REFUND functionality If you wish to install the refund functionality of the plugin, you have to install the refund extension (REFUND) after installing the main part (CBA). As this installation is rather complex, please follow the steps outlined in the INSTALLATION_GUIDE_REFUND.txt file included in the plugin s archive. 5

6 6. Configuring Amazon Payments in your ZenCart backend system once your account has passed Verification: 6.1 Sign in to your ZenCart admin area Modules > Payment > Select Checkout by Amazon Operating Environment: Select your operating environment, Sandbox (testing) or Production (live orders). Please use the Sandbox environment for configuration and testing purposes before enabling Amazon Payments in your Production environment. Please be aware that, as soon as you switch to Production, you have to have a valid SSL certificate installed on your server to be able to receive our IOPN messages. 6.2 Input your Amazon Gateway keys into your account. (See Fig 4.2) 6

7 6.3 Configure your order management settings Enable Order Management: Enable this feature to view and manage (ship, refund, or cancel) Checkout by Amazon orders within the Admin Order UI without logging in to Seller Central. Before you enable this feature make sure you have set up the cron job properly. Order status mapping: Is required to map the amazon order status with your own custom status in this site. If the recommended status is *not* available, please add it by going to your order status page For example, mystore/admin/orders_status.php Order currency: The selection depends on your Amazon Payments merchant account. Please select GBP if you have a UK merchant account. Please select EUR if you have a DE merchant account. Instant Order Processing Notification (IOPN): IMPORTANT: To be able to receive updates on your orders from Amazon Payments, and in order to see the orders in your shop s backend, enable IOPN, you should need to have an https enabled IOPN endpoint. Your IOPN End point is checkout_by_amazon.php Go to Seller Central > Settings > Checkout Pipeline Settings > Instant Order Processing Notification Settings. Click the Edit button and update the Merchant URL. Please make sure your https endpoint is secured by a valid SSL certificate that is correctly chained and issued by a trusted authority. If you do not have your own SSL certificate you may use a proxy certificate, but you will have to set the appropriate proxy endpoint URL in Seller Central. You can check the status of your SSL certificate on one of the various free SSL check services on the internet. 7

8 6.4 Check the cart page of your store. Amazon Payments will now be available and the Pay with Amazon button will be visible once you have passed business verification. 6.5 Amazon Payments Logo Placement: Include the Amazon Payments logo on your website wherever you feature payment providers as well as a banner announcing the introduction of Amazon Payments on your website. Letting customers know about Amazon Payments as early as possible in the shopping process can help increase conversion and reduce cart abandonment. For the latest selection of graphics, please visit You should verify customers can successfully place an order through Amazon Payments and it can be managed in the ZenCart backend. To do this, we recommend placing a test order on your website. Log out of Amazon Seller Central and add at least one item to your ZenCart store (ideally take the cheapest item in the shop). Pay with Amazon Payments using an Amazon customer account (not your seller account). After a few minutes the customer account will receive a shipping confirmation from Amazon. As the customer account will be charged, you should now process a full refund. Amazon will confirm the refund via . Congratulations you have successfully completed the Amazon Payments implementation! Need Help? Contact us: Webiprog Amazon Payments Support Amazon Payments Europe S.C.A., partnership limited by shares, is a company registered in Luxembourg, Registration Number B , with its corporate office at 5 Rue Plaetis, L-2338 Luxembourg. VAT Number LU Amazon Payments Europe SCA is authorised by the Commission de Surveillance du Secteur Financier as an Electronic Money Issuer (licence number 36/10). Amazon Payments is a service provided by Amazon Payments. Payments.amazon.co.uk and Amazon Payments are trading names of Amazon Payments Europe S.C.A. 8