Google CheckOut

• Documentation Home
• General Information
  • System Requirements
  • Installing WHMCS
  • Upgrading
  • Release Notes
  • Further Security Steps
  • Importing Data
  • Licensing
  • Common Troubleshooting Tips
• Key Aspects
  • Clients
  • Orders
  • Products
  • Domains
  • Invoicing
  • Transactions
  • Support Tickets
  • Messages & Emails
• Setup/Configuration
  • General Settings
  • Automation Settings
  • Payment Gateways
  • Admins/Permissions
  • Products/Services
  • Support Departments
• Developer Resources
  • Client Area Templates
  • Order Form Templates
  • Language Files
  • Action Hooks
  • Widgets
  • Creating Modules
  • API

Supported Features

Configuration

With Google Checkout, you MUST have an SSL Certificate installed on your server in order to use it. In addition to that, it must be fully valid or Google will refuse to perform the callback to the server.

Within the Google Control panel there is an integration section where you must enter the callback URL which WHMCS gives to you in the Setup > Payment Gateways page. It also gives you two options for the callback method - in WHMCS it is the XML Method that is used.

GCO Integration Setup

The option "For extra security, my company will only post digitally signed XML shopping trolleys. (Google should reject all others)" must be unchecked.

Also, in order for automatic payments you need to select the "Automatically authorise and charge the buyer's card." option in Settings > Preferences. The default of "Automatically authorise the buyer's card for the full amount of the order." will not actually capture any funds and thus won't result in invoices being marked paid.

Finally, the API version used should be 2.0.

NB: The currency in Google Checkout must match the currency in WHMCS

Error Messages

We encountered an error trying to access your server

The following error may appear in the Google Checkout Integration Console:

We encountered an error trying to access your server at https://www.yourdomain.com/whmcspath/modules/
 gateways/callback/googlecheckout.php -- the error we got is: javax.net.ssl.SSLHandshakeException: 
sun.security.validator.ValidatorException: PKIX path building failed:  sun.security.provider.certpath.
SunCertPathBuilderException: unable to find valid certification path to requested target

This is going to actually be an issue with SSL certificate. Some times the gd_intermediate_bundle from the SSL authoritie gets corrupted and then you have to ask to have a rekey to reinstall the SSL. It can also be caused by not having the gd_intermediate_bundle installed at all, but just the certificate its self.

You are not configured to post unsigned carts

This means you have ticked the For extra security, my company will only post digitally signed XML shopping trolleys. (Google should reject all others) option in your Google Checkout account settings. It should be unticked per the configuration instructions above.

Failed to Get Basic Authentication Headers=

Seeing the error "Failed to Get Basic Authentication Headers" in your Google Integration console is caused by the additional checks for added security per Google's latest best practice guides, however on certain server configurations such as those where PHP is run as CGI or Fastcgi this is not supported.

So to resolve this please edit the .htaccess file in your WHMCS directory and add the following:

RewriteEngine on
RewriteRule .* - [env=HTTP_AUTHORIZATION:%{HTTP:Authorization},last]

Future payment attempts should then be recorded automatically in WHMCS.

If the issue persists after that your server admin/hosting provider will need to enable the $_SERVER variable: HTTP_AUTHORIZATION in the server configuration which will prevent this code being needed.