Providing Google with your API callback URL

When processing orders, Google Checkout and LiteCommerce exchange data in the form of various notifications and messages. To enable your store to receive notifications and other callbacks from Google, you need to provide Google with an HTTPS API callback URL (an HTTP URL may be used for Test mode). An API callback URL tells Google Checkout where to send notifications about new orders, order state changes, and other events. Your API callback URL needs to be entered into the field 'API callback URL' in your Google Checkout merchant account ('Settings' tab->'Integration'). The URL that you need to specify can be found on the Google Checkout module configuration page. Click the Additional information >>> link at the top of the page and locate the URL after the words: This URL should be used as an 'API callback URL' in your Google Checkout account.

The URL needs to be secured by SSL v3 or TLS using a valid certificate from a major Certifying Authority. Please note that the certificate being used needs to be signed: Google Checkout does not trust unsigned certificates, so if the certificate used at your site is not signed, your store will not be able to receive any messages or notifications from Google Checkout, so the module will not be able to function correctly.

Please also note that, for Live mode, you need to provide HTTP authentication for access to this URL. See http://code.google.com/apis/checkout/developer/index.html#security_precautions for details.

The example .htaccess file bundled with LiteCommerce Google Checkout module includes the following lines which need to be uncommented and edited for correct module operation:

DirectoryIndex index.php 

#<files "callback.php"> 

#AuthType Basic 

#AuthName "Authentication required" 

#AuthUserFile /u/<your home folder>/.users 

#Require user <your merchant ID> 

#</files> 

Important!

Please note that this file is only an example and might differ depending on your web server configuration. Do not edit it unless you are sure what you are doing!

Testing your API callback URL

To test your callback URL and HTTP/HTTPS connection on Google Checkout module configuration page click the Additional information >>> link. Click Test callback URL button. If everything is set up correctly, "Trying to access the callback URL ... SUCCESS" line will be displayed.