Richard Knop's Zend Framework Blog » E-commerce http://blog.richardknop.com Zend Framework, PHP, MySQL, jQuery, JavaScript, AJAX, SEO, E-commerce and more Mon, 06 Sep 2010 15:49:00 +0000 en hourly 1 http://wordpress.org/?v=3.0.1 PHP & Google Checkout http://blog.richardknop.com/2009/10/php-google-checkout/ http://blog.richardknop.com/2009/10/php-google-checkout/#comments Tue, 06 Oct 2009 14:59:49 +0000 Richard Knop http://blog.richardknop.com/?p=450 I’ve been working on several projects lately that have involved Google Checkout integration on various levels. Besides a basic HTML integration you can get going in few seconds (just by copy and pasting the sample code from the documentation) you can also entirely integrate the checkout process with your websites through the Google Checkout API.

There are also sample classes for different languages (PHP, .NET, JSP etc) that allow you to receive responses from Google Checkout about a stage the checkout process is currently in (an order goes through many stages until it becomes processed and your customer’s credit card gets actually charged such as “REVIEWING”, “CHARGEABLE”, “CHARGING”, “CHARGED”) so you can update your local database accordingly.

There are few small errors in the sample class from Google though so I have decided to post the working version and explain briefly how to use it. Here’s a snippet from one of my projects (it’s actually a Zend Framework controller action):

  1. public function responseHandlerAction()
  2. {
  3.     // point to the correct directory
  4.     chdir(APPLICATION_PATH . '/../library/Google/Checkout');
  5.     // include all the required files
  6.     include('googlecart.php');
  7.     include('googleitem.php');
  8.     include('googleshipping.php');
  9.     include('googletax.php');
  10.     include('googleresponse.php');
  11.     include('googlerequest.php');
  12.  
  13.     $merchant_id = 'your merchant id here…';
  14.     $merchant_key = 'your merchant key here…';
  15.     $server_type = 'sandbox'; // change this to anything other than 'sandbox' to go live
  16.     $currency = 'GBP'; // USD for dollar
  17.  
  18.     $Gresponse = new GoogleResponse($merchant_id, $merchant_key);
  19.  
  20.     $Grequest = new GoogleRequest($merchant_id, $merchant_key, $server_type, $currency);
  21.  
  22.     // retrieve the XML sent in the HTTP POST request to the ResponseHandler
  23.     $xml_response = isset($HTTP_RAW_POST_DATA) ?
  24.     $HTTP_RAW_POST_DATA:file_get_contents("php://input");
  25.     if (get_magic_quotes_gpc()) {
  26.         $xml_response = stripslashes($xml_response);
  27.     }
  28.     list($root, $data) = $Gresponse->GetParsedXML($xml_response);
  29.     $Gresponse->SetMerchantAuthentication($merchant_id, $merchant_key);
  30.  
  31.     $status = $Gresponse->HttpAuthentication();
  32.     if (!$status) {
  33.         die('authentication failed');
  34.     }
  35.  
  36.     switch ($root) {
  37.         case 'new-order-notification':
  38.  
  39.             /*
  40.              * $google_id = $data[$root]['google-order-number']['VALUE'];
  41.              * $items = $this->get_arr_result($data[$root]['shopping-cart']['items']['item']);
  42.              * foreach ($items as $item) {
  43.              *     $id = $item['merchant-item-id']['VALUE'];
  44.              *     // do something here…
  45.              * }
  46.              */
  47.  
  48.             $Gresponse->SendAck();
  49.  
  50.             break;
  51.         case 'order-state-change-notification':
  52.  
  53.             $new_financial_state = $data[$root]['new-financial-order-state']['VALUE'];
  54.             $new_fulfillment_order = $data[$root]['new-fulfillment-order-state']['VALUE'];
  55.  
  56.             switch ($new_financial_state) {
  57.                 case 'REVIEWING':
  58.  
  59.                     // do something here…
  60.  
  61.                     break;
  62.                 case 'CHARGEABLE':
  63.  
  64.                     $Grequest->SendProcessOrder($data[$root]['google-order-number']['VALUE']);
  65.                     $Grequest->SendChargeOrder($data[$root]['google-order-number']['VALUE'], '');
  66.  
  67.                     break;
  68.                 case 'CHARGING':
  69.  
  70.                     // do something here…
  71.  
  72.                     break;
  73.                 case 'CHARGED':
  74.  
  75.                     /*
  76.                      * $google_id = $data[$root]['google-order-number']['VALUE'];
  77.                      * do something here…
  78.                      */
  79.  
  80.                     break;
  81.                 case 'PAYMENT_DECLINED':
  82.  
  83.                     // do something here…
  84.  
  85.                     break;
  86.                 case 'CANCELLED':
  87.  
  88.                     // do something here…
  89.  
  90.                     break;
  91.                 case 'CANCELLED_BY_GOOGLE':
  92.  
  93.                     $message = 'Sorry, your order is cancelled by Google'
  94.                     $Grequest->SendBuyerMessage($data[$root]['google-order-number']['VALUE'], $message, true);
  95.  
  96.                     break;
  97.                 default:
  98.  
  99.                     break;
  100.             }
  101.  
  102.             switch ($new_fulfillment_order) {
  103.                 case 'NEW':
  104.  
  105.                     // do something here…
  106.  
  107.                     break;
  108.                 case 'PROCESSING':
  109.  
  110.                     // do something here…
  111.  
  112.                     break;
  113.                 case 'DELIVERED':
  114.  
  115.                     // do something here…
  116.  
  117.                     break;
  118.                 case 'WILL_NOT_DELIVER':
  119.  
  120.                     // do something here…
  121.  
  122.                     break;
  123.                 default:
  124.  
  125.                     // do something here…
  126.  
  127.                     break;
  128.             }
  129.  
  130.             $Gresponse->SendAck();
  131.             break;
  132.         case 'charge-amount-notification':
  133.  
  134.             // do something here…
  135.  
  136.             $Gresponse->SendAck();
  137.  
  138.             break;
  139.         case 'chargeback-amount-notification':
  140.  
  141.             // do something here…
  142.  
  143.             $Gresponse->SendAck();
  144.  
  145.             break;
  146.         case 'refund-amount-notification':
  147.  
  148.             // do something here…
  149.  
  150.             $Gresponse->SendAck();
  151.  
  152.             break;
  153.         case 'risk-information-notification':
  154.  
  155.             // do something here…
  156.  
  157.             $Gresponse->SendAck();
  158.  
  159.             break;
  160.         default:
  161.  
  162.             // do something here…
  163.  
  164.             $Gresponse->SendBadRequestStatus('Invalid or not supported Message');
  165.  
  166.             break;
  167.     }
  168. }
  169.  
  170. private function get_arr_result($child_node) {
  171.     $result = array();
  172.     if (isset($child_node)) {
  173.         if ($this->is_associative_array($child_node)) {
  174.             $result[] = $child_node;
  175.         } else {
  176.             foreach ($child_node as $curr_node){
  177.                 $result[] = $curr_node;
  178.             }
  179.         }
  180.     }
  181.     return $result;
  182. }
  183.  
  184. private function is_associative_array($var) {
  185.     return is_array ($var) && !is_numeric (implode('', array_keys($var)));
  186. }

95% of the code above is taken from the responsehandler.php on this page. I have only made little modifications to make it all work because the original code contained few errors.

Now, how to make it all work? First, go here and download the latest sample code. Unzip the archive and copy all files except responsehandler.php and cartdemo.php to some location in your project (I just created a directory called ‘Google’ and put all files there in my library folder).

Second, you need to create a shopping cart or at least a checkout button that will take your customers to the Google Checkout page where they can pay for the product with their credit/debit cards. Here is just an example from one of my latest projects (a short excerpt of the checkout action):

  1. // point to the correct directory
  2. chdir(APPLICATION_PATH . '/../library/Google/Checkout');
  3. // include all the required files
  4. include('googlecart.php');
  5. include('googleitem.php');
  6. include('googleshipping.php');
  7. include('googletax.php');
  8.  
  9. $merchant_id = 'xxxxxxxxxxxxxxxx';
  10. $merchant_key = 'xxxxxxxxxxxxxxxxxxxxxx';
  11. $server_type = 'sandbox';
  12. $currency = 'GBP';
  13. $cart = new GoogleCart($merchant_id, $merchant_key, $server_type,
  14.                        $currency);
  15.  
  16. $item = new GoogleItem("Digital Item",
  17.                        "Description",
  18.                        1, // quantity
  19.                        $price); // unit price
  20. $item->SetMerchantItemId($id);
  21. $item->SetEmailDigitalDelivery('true');
  22. $cart->AddItem($item);
  23.  
  24. // <edit-cart-url>
  25. $cart->SetEditCartUrl('http://mydomain.com/controller/action');
  26.  
  27. // "Return to xyz" link
  28. $cart->SetContinueShoppingUrl('http://mydomain.com/controller/action');
  29.  
  30. // request buyer's phone number
  31. $cart->SetRequestBuyerPhone(false);
  32.  
  33. $this->view->checkoutButton = $cart->CheckoutButtonCode('large',
  34.                                                         true,
  35.                                                         'en_US',
  36.                                                         false);

Third, you need to configure your Google Checkout account to send callbacks to the response-handler action. Remember that when you are testing the integration in the sandbox, you can just use ordinary http:// URIs but when you go live, Google Checkout requires you to use https:// at least on the response-handler action URI.

The actual PHP integration depends on the website you want to integrate Google Checkout with so I’m not going to show you how to do that. I can give you some very basic guidelines though:

  1. I usually have a special table where I store all Google Checkout transactions. On the page with Google Checkout button I create a new row in the table and use the primary key to set a merchant item id ($item->SetMerchantItemId($id)). This helps me determine the transaction id in the response-handler action.
  2. In the “new-order-notification” callback I get the google order number and edit the transaction in the table based on the merchant item id I set earlier.
  3. In the “CHARGED” callback I mark the transaction in the table as finished based on its google order number (usually the table has a boolean field with default value 0 called “finished”, so I set it to 1).
]]> http://blog.richardknop.com/2009/10/php-google-checkout/feed/ 3