The <accept-gift-certificates> tag indicates whether customers should be able to apply gift certificates to their order totals. If this tag has a value of true, then Google Checkout will display an option for customers to enter gift certificate codes. These codes will then be passed to the merchant in a merchant calculation callback request.

The <accept-merchant-coupons> tag indicates whether customers should be able to apply coupon codes to their order totals. If this tag has a value of true, then Google Checkout will display an option for customers to enter coupon codes. These codes will then be passed to the merchant in a merchant calculation callback request.

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

The <add-tracking-data> tag contains a request to add a shipper's tracking number to an order.

The <additional-fixed-charge> tag allows you to specify a fixed charge that will be added to the total cost of an order if the buyer selects the associated shipping option. If you also adjust the calculated shipping cost using the <additional-variable-charge-percent> tag, the fixed charge will be added to the adjusted shipping rate.

The <additional-variable-charge-percent> tag specifies a percentage amount by which a carrier-calculated shipping rate will be adjusted. The tag's value may be positive or negative. For example, if the tag's value is 15, then the carrier's shipping rate will effectively be multiplied by 1.15 to determine the shipping cost presented to the buyer. So, if the carrier shipping rate were $10.00, the adjusted shipping rate would be $11.50 – i.e. $10.00 + ($10.00 X 15%). If the <additional-variable-charge-percent> tag value is negative, the calculated shipping rate will be discounted by the specified percentage.

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 <addresses> tag contains information about shipping addresses for an order.

The <adjustment-total> tag contains the total adjustment to an order total based on tax, shipping, gift certificates and coupon codes.

The <allow-us-po-box> tag indicates whether a particular shipping method can be used to ship an order to a U.S. post office (P.O.) box. To prevent a flat-rate shipping option from being offered to customers who are shipping orders to P.O. boxes in the United States, include this tag with a value of false in the shipping restrictions for the shipping option. The default value for this tag is true.

The <allowed-areas> tag contains a list of regions where a shipping option is available.

The <alternate-tax-rule> tag contains information about a tax rule that should be applied in a particular area. Each tax rule must contain either exactly one <tax-area> tag or exactly one <tax-areas> tag.

The <alternate-tax-rules> tag contains information about the taxes applied in specific areas, such as states, zip codes or postal codes. The <alternate-tax-rules> element contains a list of one or more <alternate-tax-rule> elements. These rules override the <tax-rules> for an order.

The <alternate-tax-table> tag contains information about an individual tax table, which constitutes a set of alternate-tax-rules.

The <alternate-tax-tables> tag contains a list of one or more alternate-tax-table elements. Alternate tax tables override the rules defined in the default-tax-table.

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 <analytics-data> tag enables merchants that submit server-to-server Checkout API requests to use Google Analytics to track Checkout orders. The Using Google Analytics to Track Google Checkout Orders document explains how to retrieve the appropriate value for this tag.

The <anonymous-address> tag contains a possible shipping address for an order. This address should be used to calculate taxes and shipping costs for the order.

The <applied-amount> tag contains the amount of a coupon or gift certificate that was applied to an order total.

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> tag contains the amount that was reauthorized to be charged to the customer's credit card. Google guarantees that these funds will be available for seven days – 168 hours – from the time that the reauthorization takes place.

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

The <authorization-expiration-date> tag identifies the time that a credit card authorization for an order expires.

The <authorize-order> tag contains a request to reauthorize an order. There are several possible consequences of the request:

• If the reauthorization is successful, and the customer has not been partially charged for the order, the order's financial-order-state will update to CHARGEABLE.

• If the reauthorization is successful, but the customer has already been partially charged for the order, the order's financial-order-state will update to (or remain at) CHARGED.

• If the reauthorization is unsuccessful, the order's financial-order-state will update to PAYMENT_DECLINED. In this case, the customer will have seven days – 168 hours – to submit a new card.

The <avs-response> tag contains an Address Verification System (AVS) response.

Possible values for this tag are:

The <backorder-items> command lets you specify that one or more specific items in an order are out of stock.

The <billing-address> tag contains information about the buyer's billing address.

The <buyer-account-age> tag identifies the age, in days, of the buyer's Google Checkout account.

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-language> tag identifies the customer's user interface language. At this time, this value is always en_US.

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 <bye> response indicates that Google correctly received a <hello> request.

The <calculate> tag contains details about calculations that the merchant should perform for an order.

The <calculated-amount> tag contains the calculated amount of a coupon or gift certificate.

The <cancel-items> command lets you specify that one or more specific items in an order have been cancelled, meaning they will not be delivered to the customer. You might cancel items from an order for a variety of reasons. For example, an item might be discontinued or a customer might request to remove an item that was mistakenly included in 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 <carrier> tag contains the name of the company responsible for shipping the item. Valid values for this tag are DHL, FedEx, UPS, UPS MI, UPS Mail Innovations, USPS and Other. Please note that UPS MI and UPS Mail Innovations both refer to the same UPS service.

The <carrier-calculated-shipping> tag contains information that Google will need to request shipping costs for an order from the shipment carrier. If you include a carrier-calculated shipping method in your Checkout API request, Google will obtain the shipping cost for the order based on the information that you provided and the shipping address selected by the buyer.

The <carrier-calculated-shipping-adjustment> tag communicates to a merchant the carrier-calculated shipping rate that was charged to a buyer.

The <carrier-calculated-shipping-option> tag contains information about a single shipping method for which Google Checkout should obtain shipping costs.

The <carrier-calculated-shipping-options> tag encapsulates information about all of the shipping methods for which Google Checkout should obtain shipping costs.

The <carrier-pickup> tag specifies how the package will be transferred from the merchant to the shipper. Valid values for this tag are REGULAR_PICKUP, SPECIAL_PICKUP and DROP_OFF. The default value for this tag is DROP_OFF.

The <cart-expiration> tag encapsulates information about the date that the cart expires.

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

The <charge-order> tag identifies an order for which Google should charge the customer. The <charge-order> tag may specify whether the buyer should be charged the full amount or a partial amount.

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 <code> tag contains the code for a coupon or gift certificate that was applied to an order.

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 area, shipping restriction or address filter Note that Google Checkout does not allow you to ship orders to countries that are export-embargoed for the United States. Google Checkout will return an error if your shipping restrictions or address filters include one of these countries in a shipping area. For example, Iran (IR) and North Korea (KP) may not be included in a shipping area.

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 <coupon-adjustment> tag contains information about a coupon that was applied to an order total.

The <coupon-result> tag contains information about a coupon used to calculate an order total.

The <cvn-response> tag contains a credit verification value for the order.

Possible values for this tag are:

The <date-time-zone> tag identifies the time zone that will be associated with the start-time and end-time for the report. The Order Creation Date field in the API output will also specify times in this time zone. This tag's default value is UTC, which correlates to Greenwich Mean Time (GMT).

Please see the Date and Time Gateway for a list of valid time zone values. Please note that you must combine the name of the region (e.g. America) with the locale (e.g. Chicago) in the following format: America/Chicago.

The <default-tax-rule> tag contains information about a tax rule that should be applied in a particular area. Each tax rule must contain either exactly one <tax-area> tag or exactly one <tax-areas> tag.

The <default-tax-table> tag contains the default set of rules that should be used to calculate the tax for an order.

The <deliver-order> tag indicates that Google should update an order's fulfillment order state to DELIVERED. This tag has one required attribute, which identifies the order to be updated.

The <delivery-address-category> tag indicates whether the shipping method should be applied to a residential or a commercial address. Valid values for this tag are RESIDENTIAL and COMMERCIAL.

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 <digital-content> tag contains information relating to digital delivery of an item.

The <display-disposition> tag specifies when the buyer will be able to access purchased digital content. The only valid values for this tag are OPTIMISTIC and PESSIMISTIC.

• If the value of the <display-disposition> tag is OPTIMISTIC, then Google will display instructions for accessing the digital content as soon as the buyer confirms the order. We recommend that you only use optimistic delivery if you can easily revoke access to the digital content if Google cannot authorize the customer's credit card.

• If the value of the <display-disposition> tag is PESSIMISTIC, the buyer cannot access purchased digital content until his credit card has been authorized to be charged for the amount of the order.

The default value for this tag is PESSIMISTIC.

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

The <eligible-for-protection> tag indicates whether an order is eligible for Google Checkout's payment guarantee policy.

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 <email-delivery> tag indicates that the merchant will send email to the buyer explaining how to access the digital content. Email delivery allows the merchant to charge the buyer for an order before allowing the buyer to access the digital content.

Optional. The <end-time> tag identifies the time before which a notification must have been sent to be included in the API response. The time may not be within 30 minutes of the time that the API request is submitted. For example, if the <end-time> value is 2007-06-30T15:00:00, the API will return notifications sent any time between the start time and 2007-06-30T14:59:59.

Note: The <end-time> value is exclusive, meaning the API response will include all notifications generated prior to, but not exactly at, the end time that you specify. In addition, if you specify an end time, you must also specify a start time.

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 <excluded-areas> tag identifies a list of regions where a shipping option is not available.

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 <financial-state> tag identifies the financial status of an order. Valid values for this tag are:

The <first-name> tag contains the first name of the buyer or recipient of an order. Please see the Matching Names in Notifications to Names in Your Database 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 <flat-rate-shipping> tag contains information about shipping costs that do not vary depending on the address to which the order is shipped. The <flat-rate-shipping> cost can be displayed before the buyer selects the shipping address. The <flat-rate-shipping> tag could also contain information about an offer for free shipping.

The <flat-rate-shipping-adjustment> tag contains shipping and handling costs for items that have flat-rate shipping costs.

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

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

The <gift-certificate-adjustment> tag contains information about a gift certificate that was applied to an order total.

The <gift-certificate-result> tag contains information about a gift certificate used to calculate an order total.

The <good-until-date> tag identifies the date that the order in a Checkout API request expires. The date must be specified using the ISO 8601 Date and Time Format. The time must include the time-zone designator for UTC (Coordinated Universal Time), which is "Z", or you may specify a local time along with a time-zone offset in hours and minutes. A time zone offset of "+hh:mm" indicates that the date/time uses a local time zone which is "hh" hours and "mm" minutes ahead of UTC. A time zone offset of "-hh:mm" indicates that the date/time uses a local time zone which is "hh" hours and "mm" minutes behind UTC. The examples show dates formatted using the UTC time-zone designator and using time-zone offsets.

Note: If you specify a value for this element, Google Checkout will reject the shopping cart if the user submits the cart after the specified date.

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

In a Notification History API request, when the <google-order-number> tag appears as a subtag of <order-numbers>, it specifies an order for which you are requesting notifications. When the tag appears as a subtag of <invalid-order-numbers> in a Notification History API response, it specifies an order that did not match one of your orders in the Checkout database even though you requested notifications for that order.

The <height> tag contains information about the height of the package being shipped to the customer.

The <hello> tag enables a simple test that verifies that your server communicates properly with Google Checkout. The fourth step of the Getting Started with Google Checkout section of the Developer's Guide explains how to execute this test.

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 <invalid-order-numbers> tag encapsulates a list of google order numbers for which you requested a notification history but that are not valid Google Checkout order numbers.

The <ip-address> tag contains the buyer's IP address, which Google uses to assess the risk that the order is fraudulent.

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-id> tag contains one or more values that uniquely identify an item in an order.

The <item-ids> tag encapsulates a list of items that you are marking as backordered, cancelled or returned. The <item-ids> tag may also specify a list of items for which you want to reset shipping information.

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

The <item-shipping-information> tag encapsulates information about a shipped item.

The <item-shipping-information-list> tag contains a list of <item-shipping-information> elements, each of which identifies an item in an order and may also provide shipment tracking information for that item.

The <item-weight> tag specifies the weight of an individual item in the customer's shopping cart.

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

The <key> tag contains a key needed to download or unlock a digital content item.

The <last-name> tag contains the last name of the buyer or recipient of an order. Please see the Matching Names in Notifications to Names in Your Database 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-fee-refund-amount> tag contains the amount of the transaction fee that has been refunded to the merchant for this 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 <length> tag contains information about the length of the package being shipped to the customer.

The <merchant-calculated-shipping> tag contains information about a shipping option in which Google Checkout communicates with the merchant after the shopping cart items are posted and the buyer has selected a shipping address. You may ignore this tag if you are not implementing the Merchant Calculations API, which allows merchants to use a custom process to determine taxes, shipping costs and discounts for an order after the customer has selected a shipping address.

The <merchant-calculated-shipping-adjustment> tag contains shipping and handling costs that were calculated by the merchant using a custom process.

The <merchant-calculation-callback> tag contains all information related to a request that Google Checkout sends to a merchant for custom calculations.

The <merchant-calculation-results> tag contains a response to a request for custom calculations.

The <merchant-calculation-successful> tag indicates whether Google Checkout successfully received a <merchant-calculation-results> response from your Merchant Calculations URL.

The <merchant-calculations> tag contains information about calculations that will be performed by the merchant.

The <merchant-calculations-url> tag identifies the URL to which Google Checkout should send <merchant-calculation-callback> requests. Merchants only need to include this tag in Checkout API requests if they have implemented the Merchant Calculations API.

Note: Your production calculation service must use port 443, which is the default port for HTTPS. You can use either port 443 or port 80 for your callback URL in the Sandbox environment.

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-code-results> tag contains information about coupons and gift certificates that were calculated into an order total.

The <merchant-code-string> tag contains a coupon or gift certificate code that the customer entered for an order.

The <merchant-code-strings> tag encapsulates a list of coupon or gift certificate codes that a customer has entered for an order.

The <merchant-codes> tag contains a list of gift certificate codes and coupon codes that were applied to an order total.

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. The maximum accepted length for the tag value is 255 characters.

The <method> tag identifies a shipping method for which costs need to be calculated.

The <mode> tag specifies the method that will be used to round monetary values to two decimal places. This tag may contain any of the following values, each of which is defined in the Java 1.5 specification for the RoundingMode enumeration.RoundingMode enumeration.

• UP - This mode rounds numbers away from zero. For example, the number 1.111 would be rounded to 1.12.

• DOWN - This mode rounds numbers toward zero. For example, the number 1.666 would be rounded to 1.66.

• CEILING - This mode rounds numbers toward positive infinity. For positive numbers, the CEILING mode functions identically to the UP rounding mode. For negative numbers, the CEILING mode functions identically to the DOWN rounding mode.

• HALF_UP - This mode rounds numbers to the nearest digit. However, if the number being rounded is followed by a five and no additional nonzero digits, then then that number will be rounded up. For example, the number 1.165 would be rounded to 1.17. This method is the default rounding mode for U.K. merchants.

• HALF_DOWN - This mode rounds numbers to the nearest digit. However, if the number being rounded is followed by a five and no additional nonzero digits, then then that number will be rounded down. For example, the number 1.165 would be rounded to 1.16.

• HALF_EVEN - This mode, which is also known as banker's rounding, is the default rounding mode for U.S. merchants. Banker's rounding is the same as the traditional method of rounding numbers with one exception. In banker's rounding, if the number to be rounded is followed by a five and no additional nonzero digits, the number is rounded to the nearest even number.

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.

As a subtag of <notification-history-request>, the <next-page-token> tag contains a value that identifies the set of results that should be included in the API response. For example, the <next-page-token> tag might indicate that your application had already received the first 50 notifications queued up since the start time and that the response to the next request should therefore begin with the fifty-first notification sent after the start time. Note: If your API request specifies a next-page token, then it should not specify a start time, end time, google order numbers or notification types. The token is an encrypted value that includes any filtering criteria specified in the original API request associated with that token.

As a subtag of <notification-history-response>, the <next-page-token> tag contains the token that you must submit in a subsequent notification-history-request to retrieve additional notifications matching your query parameters. Note that an API response will not include a <next-page-token> tag if either of the following conditions are true:

• The API request used the <order-numbers> tag to specify that notifications should only be returned for particular orders. In this case, the API request will include all notifications for those orders.
• The API response contains the last set of results matching the API request parameters, which means that no additional results are available.

Note: The token can be up to 511 characters long and does not have a fixed length. As such, the length of the token may vary from one request to another.

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 <notification-history-request> command lets you retrieve a list of notifications from Google Checkout. You can request notifications for particular google order numbers or for a particular date range. In addition, you can also filter your response to only include particular types of notifications.

The <notification-history-response> tag contains a response to a notification history request.

The <notification-type> tag identifies a type of notification that you would like returned in the API's notification history response. You may request more than one type of notification by adding one <notification-type> tag for each type of notification that you would like returned in the API response. If you do not specify a notification type, the API will return all notifications matching your request.

The following list identifies valid values for this tag. Each value clearly maps to a notification defined in the Google Checkout Developer's Guide.

• authorization-amount
• charge-amount
• chargeback-amount
• new-order
• order-state-change
• refund-amount
• risk-information

The <notification-types> tag encapsulates a list of <notification-type> tags, each of which identifies a type of notification that will be included in the API's notification history response. If you specify that only particular types of notifications should be included in the API response, then you must also specify either a start time and end time or a specific set of Google order numbers for which notifications should be returned.

The <notifications> tag encapsulates the list of notifications returned in the API response.

The <order-adjustment> tag contains information about adjustments to an order's total cost due to taxes, shipping, coupons and gift certificates.

The <order-list-request> command lets you retrieve a report containing a list of Google Checkout orders. You must also specify a date range for the report, and you have the option of providing filters so that the report only includes orders with particular financial or fulfillment order states. Please note that order reports contain a maximum of 5000 orders. If your report contains that many orders, you may want to reduce the interval between the start and end dates for the report to ensure that all of your orders are included in the report.

The <order-numbers> tag encapsulates a list of google order numbers for which you are requesting a notification history. You can specify up to 16 order numbers per request. The following list explains how the presence of the <order-numbers> tag affects the content of the API response:

• If you do request orders for a particular order or group of orders, the API response will include all notifications for those orders. This behavior means that if your API request identifies specific google order numbers, the API response will not include a next-page token for retrieving additional results.

• If you do not identify specific orders for which you would like a notification history, the API response will include all notifications sent between the start time and end time.

The <order-processing-support> tag contains information about how Google should process an order or how Google should convey data about the order to the merchant.

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 <parameterized-url> tag contains information about an individual web beacon that will be included on the Google Checkout order confirmation page.

The <parameterized-url> tag has one required attribute, which identifies the base URL for the web beacon. This tag also has one optional subtag, which contains the list of dynamic variables that Google Checkout should add to the base URL.

The <parameterized-urls> tag contains information about all of the web beacons that the merchant wants to add to the Google Checkout order confirmation page. This tag encapsulates a list of one or more <parameterized-url> tags.

The <parameters> tag encapsulates a list of URL parameters that will be added to the base URL for the web beacon. This tag has one subtag, <url-parameter>, which may appear multiple times.

The <partial-cc-number> tag contains the last four digits of the buyer's credit card number.

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 <pickup> tag contains information about a shipping option in which neither a carrier nor a ship-to address is specified. If there is a handling charge for pickup, that cost may be included in this value.

Note: If the customer chooses this shipping option, the new order notification that you receive for the order will not include a shipping address.

The <pickup-shipping-adjustment> tag contains shipping and handling costs for items that will be picked up by the buyer.

The <platform-id> tag should only be used by e-commerce providers who make API requests on behalf of a merchant. The tag's value contains a Google Checkout merchant ID that identifies the e-commerce provider.

Note for e-commerce Providers: The Google Checkout Terms and Conditions require e-commerce providers that manage websites for merchants who are affiliated with Google Checkout to identify themselves. The value of the <platform-id> tag should be a Google Checkout Merchant ID that uniquely identifies the e-commerce provider.

In keeping with this requirement, e-commerce providers should sign up for a Google Checkout merchant account. They should then use the merchant ID for that account as the <platform-id> tag value in Checkout API requests for all merchants using the provider's platform. However, providers should still use the merchant IDs and merchant keys assigned to the individual merchants to encode API requests from those merchants.

The <postal-area> tag specifies a geographic region somewhere in the world. As a subtag of <allowed-areas>, the <postal-area> tag contains a country where a particular shipping option is available. The tag may also contain a postal code or range of postal codes in that country where the shipping option is offered. As a subtag of <excluded-areas>, the <postal-area> tag contains a country (and possibly a zip code or range of zip codes within that country) where a particular shipping option is unavailable. As a subtag of <tax-area> or <tax-areas>, the <postal-area> tag contains a country and possibly a zip code or range of zip codes where a tax rule should be applied.

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

The <postal-code-pattern> tag contains a postal code or a range of postal codes for a specific country. To specify a range of postal codes, use an asterisk as a wildcard operator. For example, you can provide a <postal-code-pattern> value of SW* to indicate that a shipping option is available or a tax rule applies in any postal code beginning with the characters SW.

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 <price> tag contains the cost to ship an order using a particular shipping method. This tag has one required attribute, which identifies the currency of the price.

The <process-order> tag indicates that Google should update an order's fulfillment-order-state to PROCESSING.

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.

The <quantity> tag identifies how many units of a particular item are included in the customer's shopping cart.

The <rate> tag identifies a tax rate that is expressed as a multiplier.

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 seven 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-initial-auth-details> tag indicates whether Google should send an <authorization-amount-notification> when a credit card is authorized for a new 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 <reset-items-shipping-information> command allows you to reset the shipping status for specific items in an order to "Not yet shipped". This command removes shipment tracking information for an item that has already been marked as shipped. It also removes any indication that the item has been backordered, cancelled or returned.

The <result> tag contains calculations for taxes, shipping costs, and discounts for a particular shipping method and shipping address.

The <results> tag contains one or more <result> elements, each of which contains shipping, tax and discount calculations for a particular shipping method and shipping address.

The <return-items> command lets you specify that your customer returned one or more specific items in an order.

The <risk-information> tag contains information about the buyer that can be used to detect the risk, including the possibility of fraud, associated with an order.

The <risk-information-notification> tag contains information that Google uses to ensure that an order is not fraudulent. The <risk-information-notification> tag is the root tag in a risk information notification.

The <rounding-policy> tag contains information about the policy that will be used to round computed monetary values for an order.

The <rule> tag indicates when the rounding rule will be applied. Valid values for this tag are PER_LINE and TOTAL. For U.S. merchants, the default value for this tag is TOTAL. For U.K. merchants, the default value for this tag is PER_LINE. The following list explains the meaning of these two values:

• PER_LINE - This rounding rule indicates that Google should calculate the tax for each line item and round each of those tax values using the specified rounding mode. After each tax value has been rounded, Google should then add the tax values to determine the total tax.

  Note: A line item is comprised of one or more units of the same item. For example, if a shopping cart contains two identical items that each cost $1.00 and the sales tax rate is 7.5 percent, then the total cost of the line item is $2.00 and the total tax for the line item is 15 cents.

• TOTAL - This rounding rule indicates that Google should calculate the tax for each item and add those tax values to calculate the total unrounded tax amount for the order. Google should then apply the specified rounding mode to the total tax to determine the total tax for the order.

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 <ship-from> tag contains information about the location from which an order will be shipped.

The <ship-items> command lets you specify that you have shipped one or more specific items in an order. You can also use the <ship-items> command to specify shipment tracking information for each shipped item.

The <shippable> tag indicates whether an order can be shipped to the specified shipping address.

The <shipping> tag contains information about the shipping method and costs associated with an order.

When the <shipping> tag appears in a new order notification (as a subtag of <order-adjustment>), it has three possible subtags: <flat-rate-shipping-adjustment>, <merchant-calculated-shipping-adjustment> and <pickup-shipping-adjustment>.

When the <shipping> tag appears in a merchant calculation callback (as a subtag of <calculate>), its only subtag is <method>, but that tag may occur multiple times.

The <shipping-company> tag contains the name of the company that will ship the order. The only valid values for this tag are FedEx, UPS and USPS.

The <shipping-cost> tag identifies the shipping and handling amount that has been added to an order total.

The <shipping-methods> tag contains information about the different ways that an order may be shipped.

The <shipping-name> tag contains the name of the shipping method that the buyer selected for an order.

The <shipping-package> tag encapsulates information about an individual package that will be shipped to the buyer.

The <shipping-packages> tag encapsulates information about all of the packages that will be shipped to the buyer. At this time, merchants may only specify one package per order.

The <shipping-rate> tag contains the shipping costs that have been calculated for an order.

The <shipping-restrictions> tag contains information about particular areas where items can (or cannot) be shipped.

The <shipping-taxed> tag indicates whether shipping charges for an order are taxable.

The <shipping-type> tag identifies the shipping option that is being offered to the buyer. The table below shows the valid values for this tag for each carrier. None of these shipping options are for international shipping. Please note that Google will reject a Checkout API request that specifies a carrier-calculated shipping option for which the <shipping-type> is not valid for the specified carrier.

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

Optional. The <start-time> tag identifies the earliest time that a notification could have been sent to be included in the API response. The time may not be within 30 minutes of the time that the API request is submitted or more than 450 days earlier than the time that the API request is submitted.

Note: If you specify a start time, you must also specify an end time.

The <state> tag identifies a state where a particular tax rule is applied or where a particular shipping option is available or unavailable.

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 <tax> tag indicates whether the merchant needs to calculate taxes for the order.

The <tax-area> tag contains information about a region, such as a state, zip code or country, where a tax rule should be applied. The <tax-areas> tag serves the same purpose as the <tax-area> tag but can identify one or more areas where a single tax rate applies.

The <tax-areas> tag contains one or more geographic areas where a tax rule should be applied.

The <tax-rules> tag contains information about the taxes applied in particular regions, such as states, zip codes or countries. The <tax-rules> tag contains a list of one or more <default-tax-rule> elements.

The <tax-table-selector> tag identifies an alternate tax table that should be used to calculate tax for a particular item. The value of the <tax-table-selector> tag should correspond to the value of the name attribute of an alternate-tax-table.

The <tax-tables> tag contains information about all of the different rules that may be applied to calculate tax for an order.

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.