Checkout by Amazon Zen Cart Plug-in

The Checkout by Amazon team has released an updated version of the Zen Cart plug-in.
For: Version 1.3.9e

The updated plug-in supports the following features:

• Integrated with Instant Order Payment Notifications
• Dynamic Shipping and Tax Rates calculation using Callbacks.
• Amazon PayPhrase checkout integration tested
• Orders placed through Checkout by Amazon can be synched from Amazon through Merchant Feeds and managed within Zen Cart- Amazon order status history
• Reflects the statuses an order went through on Amazon and corresponding Zen Cart statuses.
• Has been tested to run with PHP4.4 and above.
• Checkout with Amazon button on the Shopping Cart page
• Amazon 1-Click and Express Checkout integration
• Signed / Unsigned Carts
• Ability to add custom data required by merchants via custom data modules

The plug-in can be found on the Zen Cart Free Addons page.

Hi,

I'm having a few problems with setting up checkout.

In sandbox, I can get to placing the order OK but once I pay, no orders show up in sellercentral or zen cart. An email of order summary is sent to the buyer but I don't receive anything. What causes this?

Thanks.

Kenichi:

Hi,

I'm having a few problems with setting up checkout.

In sandbox, I can get to placing the order OK but once I pay, no orders show up in sellercentral or zen cart. An email of order summary is sent to the buyer but I don't receive anything. What causes this?

Thanks.

Hi Kenichi,

In seller central, the orders placed will be in pending status. you have to select the Sandbox view from the website dropdown just below the navigation menus.

Also in your order list page, make sure you include pending orders to be listed.

In zencart, have you enabled order management in plugin settings? If not, please enable it.

You can check the logs under checkout_by_amazon/log/ folder for any activity.

• Amazon Payments

I'm having problems similar to Kenichi. With standard integration, I've gotten orders to show up in the zencart admin when using the sandbox and an http Merchant URL address in the checkout pipeline. However, nothing shows up with an https address in production. If I turn off order management, I still don't get orders showing up in Seller Central. Same as Kenichi says in his post, I get a buyer e-mail.

I've haven't gotten the callbacks to work in either sandbox or production. When it's enabled, checkout fails after login on amazon site with an error. The error console says:

ERROR OrderCalculationCallbacks HttpError Either there was a problem connecting to your endpoint or the merchant endpoint returned an invalid response status code.

Also, the stylesheet located at https://images-na.ssl-images-amazon.com/images/G/01/cba/styles/one-click.css and called by checkout_by_amazon_constants.php is messing up the fonts and sidebox headers in my shopping cart.

@Kenichi

1. Does your sandbox order shows up?
2. Have you updated the correct end point in the Merchant URL under Settings > Checkout Pipeline Settings > Instant Order Processing Notification Settings in seller central?

@slomojojo

1. can you check the logs under zencart dir /checkout_by_amazon/logs/ for any callback errors. You can also use Error console in Seller Central to find out what errors you are getting.
2. Have you updated the correct end point in the Merchant URL under Settings > Checkout Pipeline Settings > Instant Order Processing Notification Settings in seller central?

• Amazon Payments

Thanks, I accidentally left "yourdomain.com" in the merchant link. All seems to be working now.

It also returns me to a 404 page on my site after checkout success

/checkout_by_amazon.php?action=ResetCart&amznPmtsOrderIds=xxxxxxxxxxxxamznPmtsReqId=cartId%xxxxxxxamznPageSource=CartPage&showAmznPmtsTYPopup=etc.etc.etc

even though I don't have that set up as return URL. Is that url meant to be working? :huh:

Also I don't receive any emails saying there was a new order. How can I get zen cart and/or amazon to send an email of new order confirmation. Or will it do this in production mode?

Thanks.

Kenichi:

Thanks, I accidentally left "yourdomain.com" in the merchant link. All seems to be working now.

It also returns me to a 404 page on my site after checkout success

/checkout_by_amazon.php?action=ResetCart&amznPmtsOrderIds=xxxxxxxxxxxxamznPmtsReqId=cartId%xxxxxxxamznPageSource=CartPage&showAmznPmtsTYPopup=etc.etc.etc

even though I don't have that set up as return URL. Is that url meant to be working? :huh:

Also I don't receive any emails saying there was a new order. How can I get zen cart and/or amazon to send an email of new order confirmation. Or will it do this in production mode?

Thanks.

Hi Kenichi,

Good that you got it working.

the URL checkout_by_amazon.php which you mentioned is the redirection from amazon servers. the plugin has that file and it responsible for reset cart.

have you copied that file?

Also zencart is not enabled to send to order confirmation email when using this module as amazon sends email to the buyer. It works both in sandbox and in production mode.

• Amazon Payments

I installed the module today...however I'm receiving the following error when and order is placed. I make it all the way to Amazon but as soon as I login the below error message is displayed:

We're sorry!
We're sorry, but we're currently having problems retrieving order details from the merchant, and cannot process your order. Please return to the merchant's website and try placing your order again.

Here is the debug info from Amazon Seller Central/Error Console:

Error Type:
OrderCalculationCallbacks

Error Code:
ResponseFormatValidationError

Message:
*The OrderCalculations webservice returned a response whose format is not valid. Details: Callback response parameter 'order-calculations-response' is not provided. *

** If I dsable **Enable Callbacks **within the module settings it works.

Second issue:

I had to comment out line 65 in the file: checkout_by_amazon/checkout_by_amazon_constants.php because it messed up my shopping cart screen (CSS conflict) my question is will this cause any issues within the Amazon module?

Here is the line I commented out:

// define("CBA_STYLE_SHEET", '"https://images-na.ssl-images-amazon.com/images/G/01/cba/styles/one-click.css"');

Hey,
I've installed this, but trying to setup in Modules > Payments ... when I fill out all the settings and attemp to save it, I get an Internal Server Error ... I assume this is a permissions issue, but the installation instructions did not seem to mention any permission settings on the various files, etc ... does anyone know what permissions should be?

marcopolo:

I installed the module today...however I'm receiving the following error when and order is placed. I make it all the way to Amazon but as soon as I login the below error message is displayed:

We're sorry!
We're sorry, but we're currently having problems retrieving order details from the merchant, and cannot process your order. Please return to the merchant's website and try placing your order again.

Here is the debug info from Amazon Seller Central/Error Console:

Error Type:
OrderCalculationCallbacks

Error Code:
ResponseFormatValidationError

Message:
*The OrderCalculations webservice returned a response whose format is not valid. Details: Callback response parameter 'order-calculations-response' is not provided. *

** If I dsable **Enable Callbacks **within the module settings it works.
Can you PM the full error message?

marcopolo:

Second issue:

I had to comment out line 65 in the file: checkout_by_amazon/checkout_by_amazon_constants.php because it messed up my shopping cart screen (CSS conflict) my question is will this cause any issues within the Amazon module?

Here is the line I commented out:

// define("CBA_STYLE_SHEET", '"https://images-na.ssl-images-amazon.com/images/G/01/cba/styles/one-click.css"');

This style sheet is required for enabling one-click checkout popup. 

- Amazon Payments

fmckinnon:

Hey,
I've installed this, but trying to setup in Modules > Payments ... when I fill out all the settings and attemp to save it, I get an Internal Server Error ... I assume this is a permissions issue, but the installation instructions did not seem to mention any permission settings on the various files, etc ... does anyone know what permissions should be?

Hi fmckinnon,

Thank you for pointing out the missing part in installation instructions. we will update accordingly.

by default, when you unzip the files directly on the server, it should belong to the user it is running. when we tested on external server, we did not face such issue. however, it is good to mention about setting permissions for the php files.

• Amazon Payments

I resolved my issue with the Amazon module, had to turn on the following line in my php.ini file.

allow_call_time_pass_reference = true

Ok I found a few more issues with this module:

-When an order is made it's date in Zen Cart show as: 11/30/1999 00:00:00

so it seems that is not being populated corectly by this module.

-Tax is being carried over after an order is made however when I changed the order details from **pending **to **processing **the tax gets deleted from Zen Cart?

Shipping Logic:
-The names being exported to Amazon are the acual zen cart module names as well as the type of service. (see below) There should be a way to name these to something other then for example: UPSXML - UPS 3 Day Select the UPSXML is my module name and should not be given to the customer...they may get confused.

-Shipping rates by carriers are mixed up and not grouped? My customers see this on Amazon:

FEDEXGROUND - FedEx Home Delivery
UPSXML - UPS 3 Day Select
USPS - USPS Priority Mail
STOREPICKUP - Local Pickup
UPSXML - UPS Ground

Shouldn't it be more like this:

UPS Ground
UPS 3 Day Select
FedEx Home Delivery
USPS Priority Mail
Local Pickup (City, State)

and last "UPSXML - UPS 3 Day Select" is selected as the default and not the cheapest...which if you fix this issue then there has to be some type of exclustion BECAUSE we offer local pickup for example which is **free **and that should **NOT **be the deafult for customers because most do not want to pickup an order in person.

UPS ground or FedEx ground should be the default.

marcopolo,
Are you actually seeing your CBA orders in your ZenCart admin area? I'm getting orders, but ONLY see them in SellerCentral, they do not appear in my ZenCart admin AT ALL ... I was told by one of the CBA techs @ Amazon that this was the way it was supposed to be (for now)?

I'm really curious to know if you're seeing actual CBA orders in your ZenCart Orders Admin area??

marcopolo:

Ok I found a few more issues with this module:

-When an order is made it's date in Zen Cart show as: 11/30/1999 00:00:00

so it seems that is not being populated corectly by this module.

-Tax is being carried over after an order is made however when I changed the order details from **pending **to **processing **the tax gets deleted from Zen Cart?

Shipping Logic:
-The names being exported to Amazon are the acual zen cart module names as well as the type of service. (see below) There should be a way to name these to something other then for example: UPSXML - UPS 3 Day Select the UPSXML is my module name and should not be given to the customer...they may get confused.

-Shipping rates by carriers are mixed up and not grouped? My customers see this on Amazon:

FEDEXGROUND - FedEx Home Delivery
UPSXML - UPS 3 Day Select
USPS - USPS Priority Mail
STOREPICKUP - Local Pickup
UPSXML - UPS Ground

Shouldn't it be more like this:

UPS Ground
UPS 3 Day Select
FedEx Home Delivery
USPS Priority Mail
Local Pickup (City, State)

and last "UPSXML - UPS 3 Day Select" is selected as the default and not the cheapest...which if you fix this issue then there has to be some type of exclustion BECAUSE we offer local pickup for example which is **free **and that should **NOT **be the deafult for customers because most do not want to pickup an order in person.

UPS ground or FedEx ground should be the default.

1. see the fix here for the wrong date being updated for the order
   http://www.zen-cart.com/forum/showthread.php?p=927552#post927552

2. how are you processing the order? You should not be using zencart's status update dropdown for processing Amazon orders. In order detail page for an order, you will see action buttons that can be performed on amazon order. This action will update your zencart status accordingly.

Please take a look at html_guide/FAQ_Troubleshooting_Guide.html
#3 Is it mandatory to use the Amazon provided buttons – “Confirm Shipment”, “Cancel” and “Refund”?
Yes. Please use these buttons so that we can change the order status and execute debit/credit the customer's payment method as required.

3. Shipping Logic
   You can remove the shipping module name in line no 141 checkout_by_amazon/amazoncallback.php

old line

array_push($quoteArray,  strtoupper($quotes['id']) . " - " .  $method['title'] . " - " . $cost);

new line

array_push($quoteArray,  $method['title'] . " - " . $cost);

4. Shipping rates by carriers are sorted based on their cost before sending it to amazon during callback. Checkout by Amazon displays them in the pipeline based on the Service Levels (Standard, Expedited, One day, Two Day)

5. At present, there is no option of specifying default shipping option when sending data via callback.

fmckinnon:

marcopolo,
Are you actually seeing your CBA orders in your ZenCart admin area? I'm getting orders, but ONLY see them in SellerCentral, they do not appear in my ZenCart admin AT ALL ... I was told by one of the CBA techs @ Amazon that this was the way it was supposed to be (for now)?

I'm really curious to know if you're seeing actual CBA orders in your ZenCart Orders Admin area??

Have you configured two things?

1. configure the IOPN URL in seller central
   1.a. for Production, it should be https://yourdomain.com/checkout_by_amazon.php
   1.b. for sandbox, it should be http://yourdomain.com/checkout_by_amazon.php
2. configure the cron job as specified in the INSTALLATION_GUIDE.txt -> CONFIGURING CRON JOB

Ok the date issue fix worked and the code to remove the shipping module name worked, thank you.

As for the action buttons that you say are in the details page, I do not have them? I do not recall adding any code to that page how are they suppose to show up there?

One other issue I forgot to mention is that when an order is completed and amazon returns the customer to our website I'm geting a "Security Warning" that some stuff is not https however the page is https and everything on it on my end is properly setup for https. Is it something on your end maybe in the css files or something causing this?

marcopolo:

Ok the date issue fix worked and the code to remove the shipping module name worked, thank you.

As for the action buttons that you say are in the details page, I do not have them? I do not recall adding any code to that page how are they suppose to show up there?

One other issue I forgot to mention is that when an order is completed and amazon returns the customer to our website I'm geting a "Security Warning" that some stuff is not https however the page is https and everything on it on my end is properly setup for https. Is it something on your end maybe in the css files or something causing this?

Action buttons are displayed just below the amazon order history table in order detail page.
They are part of the plugin. no code changes are required. It is a workflow based and it gets displayed when your end point gets a notification or order reports are pulled from amazon.

Two ways the order management in zencart works with checkout by amazon

1. order placed in your zencart is notified via IOPN which will be in pending state (Amazon state). You need to map the status in the plugin settings
2. after 15 minutes, after payment confirmation, order will be ready to be processed. At this point, you will see the action buttons "Confirm Shipment" or "Cancel Order"

you have to use only them for processing the order only for (confirmation, cancel, refund).

Refund action button appears only for confirmed orders.

DO NOT USE SELLER CENTRAL FOR PERFORMING ANY ACTIONS ON ORDERS

Also you have to enable the hourly XML order report in Seller Central > Checkout Pipeline Settings > Order Report > choose XML from dropdown.

thats it.

I guess the security warning are because of the popup outlines which are the images sent via HTTP. that should be causing the security warnings i guess.

I see now where the buttons are, you have to just click on the order, using the details button they do not show on my end however that just may be because of custom modifications I have done to that page.

How can we fix the security warning issue?

On the details page shipping now shows on zen cart side (after I changed code you mentioned above) as:

Shipping - UPS Ground - 7.43: 7.43

How can I have it only say just: ** UPS Ground**
**Shipping **- UPS Ground - 7.43:
what is in bold is not needed price is populated twice one in the name colum and another is it's own colum, I ask becasue this prints on my invoices and does not look good.

And finally I have cron jobs move my orders around automatically as they go from processing to shipped, I'm assuming something custom can be programmed to do this without acually having to press those action buttons right? Where is the code that must be called to change order status if I program something custom?

** sites that get many orders will have an issue with this if that is the case.

OK I need some serious help here. I know where to put all of the files in the Includes folder. The problem is where in the world do I put all the files in the Checkout by Amazon folder.

In that folder it's sub folders are images, modules, logs and library. And it also has php files. Please help.

I am on the current version of Zen also