The <add-merchant-order-number> tag instructs Google Checkout to attach a merchant-assigned order number to an order.

The <address1> tag identifies the first line of the address to which an order is being shipped.

The <address2> tag identifies the second line of the address to which an order is being shipped.

The <amount> tag identifies the amount of money to charge or refund for an order. The tag's value may either be the full amount of the order or a partial amount. If this tag is omitted and as a part of a charge-order command, Google will charge the customer for the full amount of the order. If this tag is omitted as a part of a refund-order command, Google will refund the full order amount to the customer. This tag has one required attribute, which identifies the currency of the amount to be charged or refunded.

The <archive-order> tag indicates a request to archive a particular order. You would archive an order to remove it from your Merchant Center Inbox, indicating that the order has been delivered.

The <authorization-amount-notification> tag contains information about a successful reauthorization for an order.

The <buyer-billing-address> tag contains the billing address associated with an order.

The <buyer-id> tag contains an ID that uniquely identifies the user to Google.

The <buyer-marketing-preferences> tag contains information about the customer's contact preferences.

The <buyer-shipping-address> tag contains the shipping address for an order.

The <cancel-order> tag identifies an order that should be canceled. A <cancel-order> command sets the financial-order-state and the fulfillment-order-state to canceled.

The <charge-amount-notification> tag contains information about a successful charge for an order.

The <chargeback-amount-notification> tag contains information about a chargeback that Google Checkout processed for an order.

The <checkout-flow-support> tag contains encapsulates information used to help the customer through the checkout process.

The <checkout-redirect> tag encapsulates the URL to which a customer should be redirected when a merchant submits a shopping cart using the server-to-server technique for posting Checkout API requests.

The <checkout-shopping-cart> tag is the root tag for a Checkout API request and contains all checkout-related information.

The <city> tag identifies the city associated with an order's billing or shipping address.

The <comment> tag contains a comment related to a refunded or canceled order.

Note: The maximum accepted length for the tag value is 140 characters.

The <company-name> tag identifies the company to which an order is being shipped. Please note that Google does not currently request this information from customers but may do so in the future. However, until then, this tag will contain an empty value.

The <contact-name> tag identifies the person to whom an order is being shipped.

The <continue-shopping-url> tag contains a URL that allows the buyer to continue shopping after confirming an order.

As a subtag of <postal-area>, the <country-code> tag specifies a country associated with a tax areashipping restriction or address filter. In all other contexts, the <country-code> tag identifies the country code associated with an order's billing address or shipping address. The value of this tag must be a two-letter ISO 3166 country code.

The <demo-failure> tag enables you to test your handling of Google Checkout error messages. When you send a <demo-failure> request, Google Checkout will always return an error in the synchronous response to your request.

As a subtag of <digital-content>, the <description> tag contains instructions for downloading a digital content item. Please use the <item-description> tag to provide the description of the item being purchased. Note: This field has a maximum length of 1024 characters and may contain HTML tags. (HTML tags must be XML-escaped as described in the Google Checkout Developer's Guide.)

As a subtag of <promotion>, the <description> tag contains information about a promotion that Google applied to an order.

The <diagnosis> tag contains a diagnostic response to an API request. The diagnostic response contains the parsed XML in your request as well as any warnings generated by your request. Please see the Validating XML Messages to Google Checkout section for more information about diagnostic requests and responses.

The <edit-cart-url> tag contains a URL that allows the buyer to make changes to the shopping cart before confirming an order.

The <email> tag identifies an email address that could be used to contact the person to be billed for an order or the order recipient.

The <email-allowed> tag indicates whether the customer is willing to receive marketing emails from the merchant.

The <error> tag contains information about an invalid API request. This information is intended to help you debug the problem causing the error.

The <error-message> tag contains a message that describes why an API request caused an error.

The <fax> tag identifies a fax number that can be used to contact the person to be billed for an order or the order recipient. Please note that Google does not currently request this information from customers but may do so in the future. However, until then, this tag will contain an empty value.

The <financial-order-state> tag identifies the financial status of an order. Valid values for this tag are:

Please see the Financial Commands in the Order Processing API document for more information about these states.

The <first-name> tag contains the first name of the buyer or recipient of an order. Please see the Name Parsing section for details about Google Checkout's name-splitting algorithm.

The <flat> tag contains the flat fee amount that applies to a particular order.

The <fulfillment-order-state> tag indicates the status of an order in the order handling process. Valid values for this tag are:

The <google-order-number> tag contains an ID, which Google generates, that uniquely identifies an order.

The <id> tag specifies a value that uniquely identifies a Google Checkout promotion.

The <input-xml> tag appears in diagnostic requests and contains the XML posted in your API request after that XML has been parsed by Google Checkout. Whatever XML that you send to Google will be encapsulated within the <input-xml> tag. Please see the Validating XML Messages to Google Checkout section for more information about diagnostic requests and responses.

The <item> tag contains information about an individual item listed in the customer's shopping cart.

The <item-description> tag contains a description of an item.

The <item-name> tag identifies the name of an item.

The <items> tag contains the list of items in the customer's shopping cart.

The <last-name> tag contains the last name of the buyer or recipient of an order. Please see the Name Parsing section for details about Google Checkout's name-splitting algorithm.

The <latest-charge-amount> tag contains the amount most recently charged for a particular order.

The <latest-charge-fee> tag contains the flat rate fee and percentage fee rate as well as the total cost of the fee associated with this order.

The <latest-chargeback-amount> tag contains the amount most recently charged back against a particular order.

The <latest-chargeback-fee-amount> tag contains the amount of the chargeback fee that applies to a particular order.

The <latest-promotion-charge-amount> tag indicates how much Google contributed to the latest charge amount as a part of an ongoing promotion. For example, suppose Google offered a promotion in which a buyer who completed an order through Google Checkout received $10 off any purchase of $100 or more. If a merchant charged the customer the full amount of a $100 order, then the <latest-charge-amount> value would be $100 and the <latest-promotion-charge-amount> would be $10.

The <latest-promotion-chargeback-amount> tag indicates that a portion of the latest chargeback amount was originally paid by Google as a part of a promotion and is therefore being recouped by Google rather than by the customer. For example, suppose Google offered a promotion in which a buyer who completed an order through Google Checkout received $10 off any purchase of $100 or more. If a buyer had completed a $100 order, then the buyer would have paid $90 and Google would have paid $10 of the order total. If the buyer then disputed the charge, then the <latest-chargeback-amount> value would be $100 and the <latest-promotion-chargeback-amount> would be $10.

The <latest-promotion-refund-amount> tag indicates that a portion of the latest refund amount was originally paid by Google as a part of a promotion and is therefore being refunded to Google rather than to the customer. For example, suppose Google offered a promotion in which a buyer who completed an order through Google Checkout received $10 off any purchase of $100 or more. If a merchant refunded the customer the full amount of a $100 order, then the <latest-refund-amount> value would be $100 and the <latest-promotion-refund-amount> would be $10. Accordingly, the buyer would receive a $90 refund ($100 - $10).

The <latest-refund-amount> tag contains the most recent refund amount for a particular order.

The <merchant-checkout-flow-support> tag contains information about taxes, shipping and other custom calculations to be used in the checkout process. This tag also encapsulates URLs used during the checkout process, including URLs that allow the customer to edit a shopping cart before completing a purchase or to continue shopping after completing a purchase.

The <merchant-item-id> tag contains a value, such as a stock keeping unit (SKU), that you use to uniquely identify an item. Google Checkout will include this value in the merchant calculation callbacks and the new order notification for the order. This value also appears in the order information displayed in the Merchant Center.

Note: To use the <merchant-item-id> to modify the shipping information for an item in an order, you must have provided the same <merchant-item-id> for that item in the Checkout API request for the order.

The <merchant-order-number> tag contains the order number that you have assigned to an order. This number appears in the reconciliation report available in the Merchant Center.

The <merchant-private-data> tag contains any well-formed XML sequence that should accompany an order. Google Checkout will return this XML in the <merchant calculation callback> and the <new order notification> for the order.

The <merchant-private-item-data> tag contains any well-formed XML sequence that should accompany an individual item in an order. Google Checkout will return this XML in the <merchant calculation callback> and the <new order notification> for the order.

The <message> tag contains a message associated with a coupon or gift certificate or, when used in a <send-buyer-message> request, a message that you want to communicate to a buyer about a specific order.

Note: The maximum accepted length for the tag value is 255 characters.

The <name> tag identifies the name that Google uses to identify a promotion in the Merchant Center.

The <new-financial-order-state> tag identifies the financial-order-state for an order following a status change. The <new-financial-order-state> tag is included in an order state change notification along with a previous-financial-order-state, which identifies the financial-order-state for the order prior to the status change.

Please see the Financial Commands in the Order Processing API document or the financial-order-state element definition for a complete list of valid values for this tag.

The <new-fulfillment-order-state> tag identifies the fulfillment-order-state for an order following a status change. The <new-fulfillment-order-state> tag is included in an <order-state-change-notification> along with a previous-fulfillment-order-state, which identifies the fulfillment-order-state for the order prior to the status change.

Please see the fulfillment-order-state element definition for a complete list of valid values for this tag.

The <new-order-notification> tag contains information about a new order, including the billing address and shipping address associated with the order.

Your application must return an HTTP 200 response code when it receives and successfully processes a notification from Google Checkout. We recommend that, in the process of returning the HTTP 200 response code, your application return a <notification-acknowledgment> response, but this is not a required action.

The <order-state-change-notification> tag contains information about an order that has an updated financial-order-state or fulfillment-order-state.

The <order-total> tag contains the total cost of an order, including taxes and shipping costs as well as discounts from coupons and gift certificates.

The <percentage> tag contains the percentage fee rate that applies to a particular order.

The <phone> tag identifies a phone number that can be used to contact the person to be billed for an order or the order recipient. To receive either the phone number for the buyer or the order recipient, you must set a preference in your Google Checkout merchant account. To set this preference, log in to your merchant account and click the Settings tab. Then click the Integration link on the left side of the page. Expand the list of advanced settings and, depending on your preferences, check the box next to either or both of the following preferences:

• Return the buyer's ship-to phone number in the new order notification
• Return the buyer's billing phone number in the new order notification

Then click the Save button to update your settings.

The <postal-code> tag identifies the zip code or postal code associated with either a billing address or a shipping address.

The <previous-financial-order-state> tag identifies the financial-order-state for an order prior to a status change. The <previous-financial-order-state> tag is included in an <order-state-change-notification> along with a new-financial-order-state, which identifies the financial-order-state for the order following the status change.

Please see the Financial Commands in the Order Processing API document or the financial-order-state element definition for a complete list of valid values for this tag.

The <previous-fulfillment-order-state> tag identifies the fulfillment-order-state for an order prior to a status change. The <previous-fulfillment-order-state> tag is included in an order-state-change-notification along with a new-fulfillment-order-state, which identifies the fulfillment-order-state for the order following the status change.

Please see the fulfillment-order-state element definition for a complete list of valid values for this tag.

The <promotion> tag contains information about a single promotion that was applied to the cost of an order.

The <promotions> tag contains a list of promotions that were applied to the cost of an order.

As a subtag of <cancel-order> or <refund-order>, the <reason> tag contains the reason that you are canceling or refunding an order.

As a subtag of <order-state-change-notification>, the <reason> tag, if provided, will contain a description of the reason that Google canceled a particular order. For example, Google would cancel an order if the buyer's credit card authorization failed and the buyer did not provide updated credit card information within 168 hours (7 days). This element may be included in an order-state-change notification when an order's financial state is changed to CANCELLED_BY_GOOGLE.

Note: The maximum accepted length for the tag value is 140 characters.

The <redirect-url> tag contains the URL to which a customer should be redirected when a merchant is using the server-to-server technique for submitting Checkout API requests.

The <refund-amount-notification> tag contains information about a refund that Google Checkout granted to a customer.

The <refund-order> tag identifies an order that should be refunded. The <refund-order> tag may specify whether the buyer should be refunded the full amount of the order or a partial amount.

The <region> tag identifies the state or province associated with a billing address or shipping address.

The <request-buyer-phone-number> tag indicates whether the customer must enter a phone number to complete an order. If this tag's value is true, the customer must enter a number, which Google Checkout will return in the new order notification for the order.

The <request-received> tag confirms that Google received a properly formed request to change an order's status and that the merchant requested a valid status change. Note: This tag does not indicate that your request was successfully completed.

The <send-buyer-message> command instructs Google to send a message to a customer about a particular order.

The <send-email> tag indicates whether Google Checkout should email the buyer with updated information about the shipping status of the items in an order. Google's default behavior is to send an email. To prevent Google Checkout from sending this email, your command must include this element with a value of false.

The <shopping-cart> tag contains the list of items in a customer order and some other basic order information.

The <string> tag contains a description of a warning generated by an API request.

The <structured-name> tag contains the first name and last name of the buyer or recipient of an order. To receive first and last names in notifications, you must set a preference in your Google Checkout merchant account. To set this preference, log in to your merchant account and click the Settings tab. Then click the Integration link on the left side of the page. Expand the list of advanced settings and check the box next to the setting that says, "Provide the first name, last name and full name of the buyer and order recipient in separate fields in the new order notification." Then click the Save button to update your settings.

The <timestamp> tag contains a date and time in ISO 8601 format.

The <total> tag contains the total fee amount that applies to a particular order.

The <total-amount> tag specifies the amount that Google contributed to the cost of an order as a part of an ongoing promotion.

The <total-charge-amount> tag contains the total amount charged for a particular order.

The <total-chargeback-amount> tag contains the total amount charged back against a particular order.

The <total-refund-amount> tag contains the total refund amount for a particular order.

The <unarchive-order> tag indicates a request to unarchive a particular order. You would use this command to return an order to your Merchant Center Inbox after the order had previously been archived.

The <unit-price> tag identifies the cost of the item. This tag has one required attribute, which identifies the currency of the price.

The <warning-messages> tag contains a list of warning messages generated during Google Checkout's handling of your API request. This element is only included if your API request generated warnings.

The <warnings> tag contains a list of warning messages generated during Google Checkout's diagnosis of your API request. This element is only included if your API request generated warnings. Please see the Validating XML Messages to Google Checkout section for more information about diagnostic requests and responses.