Google Checkout for
Miva Merchant: E-commerce Solutions to Grow Online

Print Document

Table of Contents

 

Using Google Checkout in Miva Merchant 5

This module requires that you are running Miva Merchant Empresa 5.04 or greater. Miva Merchant Empresa is the engine that runs Miva Merchant. If you are unsure, please contact your host.

Product Description:

The Google Checkout module for Miva Merchant allows you to interface your online store with the Google Checkout API.

Google Checkout helps you increase sales.

And process them for free when you advertise with Google.

Every online merchant has two goals: sell more and spend less. Google Checkout™ is a new way to process transactions that helps you achieve both. Checkout works with Google's search advertising program, AdWords, to increase your sales and minimize your expenses throughout the online sales and marketing process.

Attract more leads.

Shoppers who see the Google Checkout™ badge on your AdWords ads will more easily find you when they search

Convert more leads into sales.

A fast, secure checkout process helps persuade shoppers to buy on your site and buy more often.

Process sales for free.

For every $1 you spend on AdWords, you can process $10 in sales for free. For sales that exceed this amount or if you don't use AdWords, you can process them at a low 2% and $0.20 per transaction.

Protect yourself from fraud.

Our fraud prevention tools stop invalid orders from reaching you. And our Payment Guarantee policy helps protect you from chargebacks.

 Support:

Google Group (Preferred) - http://groups-beta.google.com/group/google-checkout-for-miva-merchant/

 

Installation Instructions

Create a Google Checkout merchant account

If you don’t have a Google Checkout merchant account you need to create one now. Go to https://checkout.google.com/sell and click the “Sign up now” link. Follow the prompts and complete the sign-up process.

 

When you have created your merchant account, click the Settings tab and then the Integration link. Enter a callback URL and select the “name/value pairs” radio button.

Your callback URL will look like this: https://www.yourdomain.com/Merchant2/google/google.mvc

Note that “Merchant2” may differ from your store.

 

Add Module (Empessa 5.04+ Required)

To add the Google Checkout module you must upload it to your Miva Merchant domain and then add it to your store.

Add Module to the Miva Merchant Domain

Use the following procedure to add modules to your Miva Merchant domain.

1. Click the triangle next to Modules.

2. Click Add Module.

 

The Add Module screen is displayed.

3. If you know the module name, enter it and go to step 5.

4. If you do not know the module name, click the Upload File button.

 

The Upload File screen is displayed.

a. Use the Browse... button to find the module on your system.

b. You are uploading a new module that is not in your Miva Merchant domain.

    Therefore, you do not need to click the Overwrite check box.

c. Click the Upload button to return to the Add Module form.

 

5. In the Add Module screen, click the Add button.

6. To undo your steps, click the Reset button to delete the module from the domain.

 

7. After you click the Add button, the module (A New Payment Module in the sample below) is added to the module list as the last item.

 

Assign Module to a Miva Merchant Store

After you have added the module to your domain, use the following procedure to assign it to your store(s).

1. Click the triangle    to the left of Stores on the menu to display the stores in the Miva Merchant domain.

2. Click the triangle    to the left of the store name (Tool Crib) to display the list of stores functions.

3. Click the desired module configuration type to open the Module Configuration form.

 

1. Click Update to assign the module to the store.

 

Configuring the module

Enter your Merchant ID, Merchant Key, select the API status, and select your checkout button size.

 

Google Checkout Extensions

These extensions allow you to connect Google Checkout Compatible discount modules. For example, these modules would be a coupon module or a gift certificate module.

1. Click the yellow icon to add a new extension

2. Enter the module code, select the type, and click “Update”.

 

Google Checkout Compatible Modules (Contact vendor for latest version)

Coupon Redemption – Emporiumplus.com

Order Details

Each Google Checkout order in your administration will have a Google Checkout tab contain the details of the particular order.

Order List

Administration for all your Google Checkout orders.

1. Order Filters

2. Action Type

3. Tracking Number

4. Tracking Type

How to Administer your Google Checkout Orders

Each order placed by using the Google Checkout module will allow you to select an action for the order. When an action is selected and the “Update” button is clicked, the information required for that action is communicated to Google.

Action Types

1. Charge Order

The Charge Order command instructs Google Checkout to charge the buyer for a particular order. After an order reaches the CHARGEABLE order state, you have 72 hours to capture funds by issuing a Charge  Order command. You may issue a Charge Order command for an order that is in any of the following financial order states:

REVIEWING

CHARGEABLE

CHARGED (if the order has only been partially charged)

Note: Even after you have issued a Charge Order command, you should not assume that Google has charged your customer until you see the Financial state say CHARGED. In addition, if you charge an order that is in the REVIEWING financial order state, the charge will not take place until Google has updated the financial order state to CHARGEABLE.

2. Refund Order

The Refund Order command instructs Google Checkout to refund the buyer for a particular order. You may issue a Refund Order command after an order has been charged and is in the CHARGED financial order state.

Note: Even after you have issued a Refund Order command, you should not assume that Google has refunded your customer until you see the Financial state say REFUNDED confirming that the refund has been processed.

3. Cancel Order

The Cancel Order command instructs Google Checkout to cancel a particular order. If the customer has already been charged, you must refund the customer's money before you can cancel the order. You may issue a Cancel Order command for an order that is either of the following financial order states:

CHARGEABLE

PAYMENT_DECLINED

Note: Even after you have issued a Cancel Order command, you should not assume that Google has canceled the order until you see the Financial state say CANCELLED confirming that the financial order state was updated to CANCELLED.

4. Process Order

The Process Order command instructs Google Checkout to update an order's fulfillment state from NEW to PROCESSING.

When you issue a Process Order request, Google Checkout displays a note in the buyer's inbox indicating that you are processing the order. This command is optional. If you do not send a Process Order request, Google will not display the message.

5. Deliver Order

The Deliver Order command instructs Google Checkout to update an order's fulfillment state from either NEW or PROCESSING to DELIVERED. You would send this command after the order has been charged and shipped.

6. Archive Order

The Archive Order command instructs Google Checkout to remove an order from your Merchant Center Inbox. We recommend that you only archive orders after they have been delivered or canceled.

7. Un-Archive Order

The Un-Archive Order> command instructs Google Checkout to return a previously archived order to your Merchant Center Inbox.

8. Add Tracking Data

The Add Tracking Data command instructs Google Checkout to associate a shipper's tracking number with an order. The Google Checkout Program Policies and Guidelines state that you must provide shipment tracking information for your orders as that information becomes available. This command does not impact the order's fulfillment state.

9. Send Buyer Message

The Send Buyer Message command instructs Google Checkout to place a message in the customer's Google Checkout account. It will also email the message to the customer. This command does not impact the order's fulfillment state.

Checkout Buttons & Usage

When implementing the Google Checkout button on your website, please adhere to the requirements outlined below. If you don’t, the Google Checkout icon may be removed from your AdWords ads and your merchant account may be suspended.

Button Placement

or

Buyer experience

For more detail on each requirement, visit the Google Checkout policies page.

Displaying the Google Checkout button

In order for the Google Checkout button to display, you must be using a template based interface.

Place the token on the Basket page in a location according to Google Guidelines.

License:

Please read the following: https://checkout.google.com/seller/content_policies.html

FAQ:

Q. The shipping options sent to Google Checkout dont match what my normal checkout would have.

A. This would typically happen if you were using a third party to alter the display of the shipping methods. To correct this, we recommend using the Shipping SuperMod available to MivaCentral.com. The Shipping SuperMod acts as a gateway, so accurate shipping methods are created based on the order criteria.

Q. I added the module token, but I am not seeing the button display.

A. First, the button will only display if there are contents within your basket. Second, double check that you have created and inserted the token using the correct syntax.

Q. I'm getting a 401 Authorization Error in my Google Checkout Integration Issues Report.

A. This is because the Google Checkout Connector file for Miva Merchant is unable to authenticate when Google communicates with it. Double checking your account settings in the modules administration panel and clicking “Update” should correct it. Click “Update” recreates the connector file with updated permissions.