Google Checkout: Demystifying International Shipping...And More

Google Checkout: International Shipping

"....merchant does not ship to..."

By default, Google Checkout Merchants can only accept orders delivered to their account's country. Customers of US merchants can only provide delivery addresses within the US, and customers of UK merchants can only choose a UK delivery address. Otherwise, the error message above will be displayed.

This working sample (sandbox/test) shows how to "enable" international shipping. "Enable" isn't exactly the right term - its not an account setting. International shipping is set in the information you send to Google Checkout.

This sample is all HTML (no Javascript needed). It shows how to implement international shipping accross the HTML implementations of Google Checkout - i.e. Buy Now Button, Shopping Cart and (basic) HTML API.

What it does:

"Enables" international shipping
Displays the appropriate shipping options/rates depending on delivery address
- US customer will only see US applicable shipping rates
- International customer will only see international rates
- Further classifies US deliveries between Continental US and Alaska (AK) and Hawaii (HI) shipping rates and options, and displays appropriate rates (only).
- Further classifies International deliveries between Canada and the rest of the world and displays appropriate rates (only).

To fully test the sample, create different delivery addresses in your Sandbox account (i.e. a California address, an Alaska address, a Canadian address, and a German address) and switch/change on checkout.

Source code and reference for each is provided below.

Shopping Cart

PayCircuit T-shirt
Price: $29.99
Color: Black
Brand: Paycircuit
Description The best shirt ever
Your notes:

PayCircuit Coffee Mug
Price: $5.99
Text to print on mug:

Buy Now Button

PayCircuit T-shirt
Price: $29.99
Color: Black
Brand: Paycircuit
Description: The best shirt ever

HTML API

PayCircuit Coffee Mug
Price: $5.99
Text to print on mug:

Google Shopping Cart

Notes:

Provide your own Merchant ID (replace the mid=000000000000000 with your own merchant ID)
post-cart-to-sandbox="true" is for Sandbox testing
post-cart-to-sandbox="false" for production/live use
See HTML comments for more details

<div class="product" style="margin: 10px 0px 20px 0px;"> <span class="product-title">PayCircuit T-shirt</span> <br />
  Price: <span class="product-price">$29.99</span> <br />
  Color: <span class="product-attr-color">Black</span> <br />
  Brand: <span class="product-attr-brand">Paycircuit</span> <br />
  Description <span class="product-description">The best shirt ever</span> <br />
  Your notes:
  <input class="product-attr-something" type="text" />
  <input class="product-weight" type="hidden" value="1" />
  <div class="googlecart-add-button"> </div>
</div>

<div class="product"> <span class="product-title">PayCircuit Coffee Mug</span> <br />
  Price: <span class="product-price">$5.99</span> <br />
  Text to print on mug:
  <input class="product-attr-something" type="text" />
  <input class="product-weight" type="hidden" value="2" />
  <div class="googlecart-add-button"> </div>
</div>

<form id="googlecart-checkout-config">

  <input type="hidden" name="ship_method_name_1" value="USPS Priority Mail" />
  <input type="hidden" name="ship_method_price_1" value="4.95" />
  <input type="hidden" name="ship_method_currency_1" value="USD" />
  <input type="hidden" name="ship_method_name_2" value="USPS Priority Mail with Delivery Confirmation" />
  <input type="hidden" name="ship_method_price_2" value="5.60" />
  <input type="hidden" name="ship_method_currency_1" value="USD" />
  <input type="hidden" name="ship_method_name_3" value="FedEx Ground" />
  <input type="hidden" name="ship_method_price_3" value="10.00" />
  <input type="hidden" name="ship_method_currency_3" value="USD" />
  <input type="hidden" name="ship_method_name_4" value="FedEx Express Saver" />
  <input type="hidden" name="ship_method_price_4" value="15.00" />
  <input type="hidden" name="ship_method_currency_4" value="USD" />
  <input type="hidden" name="ship_method_name_5" value="FedEx 2Day" />
  <input type="hidden" name="ship_method_price_5" value="18.00" />
  <input type="hidden" name="ship_method_currency_5" value="USD" />
  
  <!--this says shipping options 1 through 5 are only for US Continental 48 States -->
  <input type="hidden" name="ship_method_us_area_1" value="CONTINENTAL_48" />
  <input type="hidden" name="ship_method_us_area_2" value="CONTINENTAL_48" />
  <input type="hidden" name="ship_method_us_area_3" value="CONTINENTAL_48" />
  <input type="hidden" name="ship_method_us_area_4" value="CONTINENTAL_48" />
  <input type="hidden" name="ship_method_us_area_5" value="CONTINENTAL_48" />

  <!--Shipping option 6 is for Alaska and Hawaii rates. AK and HI are not part of Continental 48-->
  <input type="hidden" name="ship_method_name_6" value="FedEx 2Day - Alaska and Hawaii" />
  <input type="hidden" name="ship_method_price_6" value="24.00" />
  <input type="hidden" name="ship_method_currency_6" value="USD" />
  
  <!--International Section -->
  <input type="hidden" name="ship_method_name_7" value="International Flat Rate" />
  <input type="hidden" name="ship_method_price_7" value="45.00" />
  <input type="hidden" name="ship_method_currency_7" value="USD" />
  
  <!-- International: Canada (only) rate, all other countries will use option 7 -->
  <input type="hidden" name="ship_method_name_8" value="Canada Flat Rate" />
  <input type="hidden" name="ship_method_price_8" value="25.00" />
  <input type="hidden" name="ship_method_currency_8" value="USD" />
  
  <!-- We now restrict the shipping options above accordingly -->
  
  <!-- This restricts option 6, Fedex 2Day Alaska and Hawaii, display to customers who have AK and HI delivery addresses -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-6.shipping-restrictions.allowed-areas.us-state-area-1.state" value="AK" />
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-6.shipping-restrictions.allowed-areas.us-state-area-2.state" value="HI" />
  
  <!-- All international countries (except Canada, more below) will use this rate -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-7.shipping-restrictions.allowed-areas.world-area-1" value="true" />
  
  <!-- we don't want the above rate displayed to US delivery destinations -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-7.shipping-restrictions.excluded-areas.us-country-area-1.country-area" value="ALL" />
  
  <!-- we don't want the above rate displayed to Canada delivery destinations either -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-7.shipping-restrictions.excluded-areas.postal-area-1.country-code" value="CA" />
  
  <!-- We now set the rate for Canada -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-8.shipping-restrictions.allowed-areas.postal-area-1.country-code" value="CA" />

</form>

<!-- replace mid with your merchant id -->
<!-- set post-cart-to-sandbox = false when done testing -->

<script id="googlecart-script" type="text/javascript" src="http://checkout.google.com/seller/gsc/v2_2/cart.js?mid=000000000000000" currency="USD" post-cart-to-sandbox="true">
</script>

Buy Now and HTML API

Why combined? Because the code is identical except for the FORM POST URL and Google Image Buttons.
Tip: this is a key concept in Google Checkout. The "core" HTML API is spread across different implementations. You will even notice the identical code used above in the shopping cart.

Notes:

Provide your own Merchant ID (replace the mid=000000000000000 with you own merchant ID)
See HTML comments for more details

<form action="https://sandbox.google.com/checkout/api/checkout/v2/checkoutForm/Merchant/000000000000000" id="Form2" method="post" name="BB_BuyButtonForm">
  
  PayCircuit T-shirt
  <input name="item_name_1" type="hidden" value="PayCircuit T-shirt" />
  <br />
  Price: $29.99
  <input name="item_price_1" type="hidden" value="29.99" />
  <br />
  Color: Black <br />
  Brand: Paycircuit <br />
  Description: The best shirt ever <br />
  <input name="item_description_1" type="hidden" value="Brand: Paycircuit, Color: Black, The best shirt ever" />
  <input name="item_quantity_1" type="hidden" value="1" />
  <input name="item_currency_1" type="hidden" value="USD" />
  <input name="item_weight_unit_1" type="hidden" value="LB" />
  <input name="_charset_" type="hidden" value="utf-8" />
  <input name="item_weight_1" type="hidden" value="1" />
  
  <input type="hidden" name="ship_method_name_1" value="USPS Priority Mail" />
  <input type="hidden" name="ship_method_price_1" value="4.95" />
  <input type="hidden" name="ship_method_currency_1" value="USD" />
  <input type="hidden" name="ship_method_name_2" value="USPS Priority Mail with Delivery Confirmation" />
  <input type="hidden" name="ship_method_price_2" value="5.60" />
  <input type="hidden" name="ship_method_currency_1" value="USD" />
  <input type="hidden" name="ship_method_name_3" value="FedEx Ground" />
  <input type="hidden" name="ship_method_price_3" value="10.00" />
  <input type="hidden" name="ship_method_currency_3" value="USD" />
  <input type="hidden" name="ship_method_name_4" value="FedEx Express Saver" />
  <input type="hidden" name="ship_method_price_4" value="15.00" />
  <input type="hidden" name="ship_method_currency_4" value="USD" />
  <input type="hidden" name="ship_method_name_5" value="FedEx 2Day" />
  <input type="hidden" name="ship_method_price_5" value="18.00" />
  <input type="hidden" name="ship_method_currency_5" value="USD" />
  
  <!--this says shipping options 1 through 5 are only for US Continental 48 States -->
  <input type="hidden" name="ship_method_us_area_1" value="CONTINENTAL_48" />
  <input type="hidden" name="ship_method_us_area_2" value="CONTINENTAL_48" />
  <input type="hidden" name="ship_method_us_area_3" value="CONTINENTAL_48" />
  <input type="hidden" name="ship_method_us_area_4" value="CONTINENTAL_48" />
  <input type="hidden" name="ship_method_us_area_5" value="CONTINENTAL_48" />
  
  <!--Shipping option 6 is for Alaska and Hawaii rates. AK and HI are not part of Continental 48-->
  <input type="hidden" name="ship_method_name_6" value="FedEx 2Day - Alaska and Hawaii" />
  <input type="hidden" name="ship_method_price_6" value="24.00" />
  <input type="hidden" name="ship_method_currency_6" value="USD" />
  
  <!--International Section -->
  <input type="hidden" name="ship_method_name_7" value="International Flat Rate" />
  <input type="hidden" name="ship_method_price_7" value="45.00" />
  <input type="hidden" name="ship_method_currency_7" value="USD" />
  
  <!-- International: Canada (only) rate, all other countries will use option 7 -->
  <input type="hidden" name="ship_method_name_8" value="Canada Flat Rate" />
  <input type="hidden" name="ship_method_price_8" value="25.00" />
  <input type="hidden" name="ship_method_currency_8" value="USD" />
  
  <!-- We now restrict the shipping options above accordingly -->
  
  <!-- This restricts option 6, Fedex 2Day Alaska and Hawaii, display to customers who have AK and HI delivery addresses -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-6.shipping-restrictions.allowed-areas.us-state-area-1.state" value="AK" />
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-6.shipping-restrictions.allowed-areas.us-state-area-2.state" value="HI" />
  
  <!-- All international countries (except Canada, more below) will use this rate -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-7.shipping-restrictions.allowed-areas.world-area-1" value="true" />
  
  <!-- we don't want the above rate displayed to US delivery destinations -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-7.shipping-restrictions.excluded-areas.us-country-area-1.country-area" value="ALL" />
  
  <!-- we don't want the above rate displayed to Canada delivery destinations either -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-7.shipping-restrictions.excluded-areas.postal-area-1.country-code" value="CA" />
  
  <!-- We now set the rate for Canada -->
  <input type="hidden" name="checkout-flow-support.merchant-checkout-flow-support.shipping-methods.flat-rate-shipping-8.shipping-restrictions.allowed-areas.postal-area-1.country-code" value="CA" />
  <input alt="" src="https://sandbox.google.com/checkout/buttons/buy.gif?merchant_id=000000000000000&w=117&h=48&style=white&variant=text&loc=en_US" type="image" />

</form>