Google Checkout Notification API - Outlines

Notification API:

Responding to Notifications:
- Using HTTP response codes to indicate successful or failed processing:

- Using a notification handshake to confirm successful processing:
check the box that says, "Require notification acknowledgments to specify the serial number of

the notification."


##############################################################
New Order Notifications:
inform you of new orders that have been submitted through Google Checkout.

- shopping cart :
list of items, expiration date for the shopping cart

- order-adjustment :
shipping method, shipping cost, taxes charged, coupons and gift certificates, if you implemented

the Merchant Calculations API

- buyer-billing-address :
billing addresses for the order

- buyer-shipping-address :
shipping addresses for the order

- order-total :
- Order total by adding the price of the items, shipping charges and taxes, and then subtracting

adjustments for coupons and gift certificates.

- buyer-id :
- ID that Google uses to uniquely identify a user

- buyer-marketing-preferences :
- Whether the buyer would like to receive marketing emails from you


##############################################################
Risk Information Notifications:
Includes financial information such as the customer's billing address, a partial credit card

number and other values that help you verify that an order is not fraudulent.

Note: Before shipping the items in the order, you should wait until you have also received the

new order notification for the order and the order state change notification informing you that

the order's financial state has been updated to CHARGEABLE.

Risk-information:
- Contains information about the buyer that can be used to detect the risk, including the

possibility of fraud, associated with an order. Below are the subtags:

Billing-address:
- Address1, address2?, city, company-name?, contact-name, country-code, email?, fax?, phone?,

postal-code, region

Avs-response:
Y - Full AVS match (address and postal code)
P - Partial AVS match (postal code only)
A - Partial AVS match (address only)
N - no AVS match
U - AVS not supported by issuer

Buyer-account-age:
- Identifies the age, in days, of the buyer's Google Checkout account.

Cvn-response:
M - CVN match
N - No CVN match
U - CVN not available
E - CVN error

Eligible-for-protection:
- Indicates whether an order is eligible for Google Checkout's payment guarantee policy.

Ip-address:
- Buyer's IP address

Partial-cc-number:
- Contains the last four digits of the buyer's credit card number.


##############################################################
Order State Change Notifications:
- Signal an update to an order's financial status or its fulfillment status

- Notify you that an order's financial status or its fulfillment status has changed
The notification identifies the new financial and fulfillment statuses for the order
as well as the previous statuses for that order.

For example:
- If you send Google Checkout a request,
Google will respond through the Order Processing API
to inform you that it changed the order's status to CANCELLED.

Financial-order-state:
- identifies the stage of the payment process where the order is located.

- Valid financial states include
- REVIEWING : default financial state for all new orders.
- may issue cmd
- CHARGEABLE : may issue cmd
- CHARGING: indicates that Google is in the process of charging the customer.
- No cmd
- CHARGED : you have fully or partially (amount) charged the customer for an order.
- may issue cmd
- PAYMENT_DECLINED : Google's effort to authorize or charge the customer's CC failed.
- may issue cmd
- CANCELLED : either the buyer or the merchant canceled the order.
- buyer's credit card is declined
- buyer can cancel an order within 15 minutes of placing that order.
- CANCELLED_BY_GOOGLE : Google may cancel an order if the CC authorization fails
and the customer does not provide a new CC within 72 hours.

- Financial commands:
Enable you to authorize or perform credit card transactions for an order.
- charge-order
- refund-order
- cancel-order
- authorize-order

Fulfillment order state:
- Enables you to track orders through the fulfillment process
and to convey the fulfillment status to the buyer.

- Valid order's fulfillment states:
- NEW : Unless, one item in the order is either not yet shipped or backordered.
- if all of the items in the order are either shipped, cancelled or returned.
- if you reset the shipping status of any items in the order.
- PROCESSING :
- DELIVERED : if all of the items in the order have either been shipped,
returned or cancelled.
- may use cmd
- WILL_NOT_DELIVER : if all of its items have been cancelled.
- may use cmd

- API commands : used for either line-item shipping or order-level shipping API integration.

A) Line-item shipping commands:

ship-items:
specify shipping information for one or more items in an order.
- use merchant item IDs to identify the items in your order.
- identifies the carrier responsible for shipping the item
- you have the option of also providing the order tracking number for the shipment.

backorder-items:
items are out of stock.
- use merchant item IDs to identify the items in your order.

cancel-items:
items that are being removed from an order
- initiated by the merchant or by a request from the buyer.

return-items:
items that were shipped and sent back to the merchant for a replacement product or a refund.

reset-items-shipping-information:
you remove the shipping status associated with one or more items
and return those items to the not yet shipped state.

add-merchant-order-number:
instructs Google Checkout to associate a merchant-assigned order number with an order.

send-buyer-message:
instructs Google Checkout to place a message in the buyer's Google Checkout account.
- element indicates that Google should email the customer


B) Order-level shipping commands:

process-order:
instructs Google Checkout to update an order's fulfillment state from NEW to PROCESSING
- This cmd is optional.

deliver-order:
instructs Google Checkout to update an order's fulfillment state from
either NEW or PROCESSING to DELIVERED.
- You would send this cmd after the order has been charged and shipped.

add-tracking-data:
- instructs Google Checkout to associate a shipper's tracking number with an order.

cancel-order:
instructs Google Checkout to cancel a particular order of states CHARGEABLE or PAYMENT_DECLINED
- If the customer has already been charged,
you must refund the customer's money before you can cancel the order.

add-merchant-order-number:
instructs Google Checkout to associate a merchant-assigned order number with an order.

send-buyer-message:
instructs Google Checkout to place a message in the buyer's Google Checkout account.
- element indicates that Google should email the customer


C) Archiving commands:
Manage the list of orders in your Merchant Center inbox.
Archiving commands do not have any impact on an order's status

archive-order:
instructs Google Checkout to remove an order from your Merchant Center Inbox.
- using google-order-number

unarchive-order:
instructs Google Checkout to return a previously archived order to your Merchant Center Inbox.
- using google-order-number


##############################################################
Amount Notifications:
Google defines a set of notifications that report info about financial txns for an order.

a) Charge Amount Notifications:
Sent after successfully charging a customer for an order.
- GC > Settings > Preferences > "Automatically authorize and charge the buyer's credit card."

b) Refund Amount Notifications:
Sent after successfully executing a order processing command.

c) Chargeback Amount Notifications:
Sent when a customer initiates a chargeback against an order
and Google approves the chargeback.

d) Authorization Amount Notifications:
Sent in response to a successful request for an explicit CC reauthorization.