- JSON representation
- Contents
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- Promotion
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
Order entity. Note: 1. All strings at all levels must be less than 1000 chars unless otherwise specified. 2. All repeated fields at all levels must be less than 50 in count unless otherwise specified. 3. All timestamps at all levels, if specified, must be valid timestamps.
JSON representation | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
Fields | ||
---|---|---|
googleOrderId |
Google assigned order id. |
|
merchantOrderId |
Required: Merchant assigned internal order id. This id must be unique, and is required for subsequent order update operations. This id may be set to the provided googleOrderId, or any other unique value. Note that the id presented to users is the userVisibleOrderId, which may be a different, more user-friendly value. Max allowed length is 128 chars. |
|
userVisibleOrderId |
The user facing id referencing to current order. This id should be consistent with the id displayed for this order in other contexts, including websites, apps and email. |
|
userVisibleStateLabel |
Deprecated: Use OrderExtensions status instead. User visible label for the state of this order. |
|
buyerInfo |
info about the buyer. |
|
image |
Image associated with the order. |
|
createTime |
Required: date and time the order was created. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: |
|
lastUpdateTime |
date and time the order was last updated. Required for OrderUpdate. A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: |
|
transactionMerchant |
Merchant that facilitated the checkout. This could be different from a line item level provider. Example: Expedia Order with line item from ANA. |
|
contents |
Required: Order contents which is a group of line items. |
|
priceAttributes[] |
Price, discounts, taxes and so on. |
|
followUpActions[] |
Follow up actions at order level. |
|
paymentData |
Payment related data for the order. |
|
termsOfServiceUrl |
A link to the terms of service that apply to order/proposed order. |
|
note |
Notes attached to an order. |
|
promotions[] |
All promotions that are associated with this order. |
|
disclosures[] |
Disclosures associated with this order. |
|
vertical |
Deprecated: Use verticals instead. These properties will apply to all line items, unless overridden in some line item. This vertical must match the line item level vertical type. Possible values: An object containing fields of an arbitrary type. An additional field |
|
Union field verticals . These properties will apply to all line items, unless overridden in some line item. This vertical must match the line item level vertical type. verticals can be only one of the following: |
||
purchase |
Purchase order |
|
ticket |
Ticket order |
Contents
Wrapper for line items.
JSON representation | |
---|---|
{
"lineItems": [
{
object ( |
Fields | |
---|---|
lineItems[] |
List of order line items. At least 1 lineItem is required and at-most 50 is allowed. All line items must belong to same vertical. |
PaymentData
Payment data related to an order.
JSON representation | |
---|---|
{ "paymentResult": { object ( |
Fields | |
---|---|
paymentResult |
Payment result that's used by integrator for completing a transaction. This field will be populated by actions on Google if the checkout experience is managed by actions-on-Google. |
paymentInfo |
Payment information regarding the order that's useful for user facing interaction. |
PaymentResult
Payment result used by integrator for completing a transaction.
JSON representation | |
---|---|
{ // Union field |
Fields | ||
---|---|---|
Union field result . Either google payment data or merchant payment method is provided. result can be only one of the following: |
||
googlePaymentData |
Google provided payment method data. If your payment processor is listed as Google supported payment processor here: https://developers.google.com/pay/api/ Navigate to your payment processor through the link to find out more details. Otherwise, refer to following documentation for payload details. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Merchant/Action provided payment method chosen by user. |
PaymentInfo
Payment information regarding the order being made. This proto captures information that's useful for user facing interaction.
JSON representation | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Fields | |
---|---|
paymentMethodDisplayInfo |
The display info of the payment method used for the transaction. |
paymentMethodProvenance |
Provenance of the payment method used for the transaction. User may have registered the same payment method with both google and merchant. |
PaymentMethodDisplayInfo
Payment result used by integrator for completing a transaction.
JSON representation | |
---|---|
{
"paymentType": enum ( |
Fields | |
---|---|
paymentType |
The type of the payment. |
paymentMethodDisplayName |
User visible name of the payment method. For example, VISA **** 1234 Checking acct **** 5678 |
Promotion
Promotions/Offers that were added to the cart.
JSON representation | |
---|---|
{ "coupon": string } |
Fields | |
---|---|
coupon |
Required: Coupon code applied to this offer. |
PurchaseOrderExtension
Order extension for purchase vertical. These properties are applicable to all line items inside order, unless overridden in a line item.
JSON representation | |
---|---|
{ "status": enum ( |
Fields | |
---|---|
status |
Required: Overall Status for the order. |
userVisibleStatusLabel |
User visible label/string for the status. Max allowed length is 50 chars. |
type |
Required: type of purchase. |
returnsInfo |
Return info for the order. |
fulfillmentInfo |
Fulfillment info for the order. |
extension |
Any extra fields exchanged between merchant and google. An object containing fields of an arbitrary type. An additional field |
purchaseLocationType |
Location of the purchase (in-store / online) |
errors[] |
Optional: Errors because of which this order was rejected. |
PurchaseError
Errors that a purchase order can be rejected for.
JSON representation | |
---|---|
{ "type": enum ( |
Fields | |
---|---|
type |
Required: This represents the granular reason why an order gets rejected by the merchant. |
description |
Additional error description. |
entityId |
Entity Id that corresponds to the error. Example this can correspond to LineItemId / ItemOptionId. |
updatedPrice |
Relevant in case of PRICE_CHANGED / INCORRECT_PRICE error type. |
availableQuantity |
Available quantity now. Applicable in case of AVAILABILITY_CHANGED. |
TicketOrderExtension
Order contents for ticket orders like movie, sports etc.
JSON representation | |
---|---|
{
"ticketEvent": {
object ( |
Fields | |
---|---|
ticketEvent |
The event applied to all line item tickets. |
TicketEvent
Represents a single event.
JSON representation | |
---|---|
{ "type": enum ( |
Fields | |
---|---|
type |
Required: type of the ticket event, e.g. movie, concert. |
name |
Required: name of the event. For example, if the event is a movie, this should be the movie name. |
description |
description of the event. |
url |
Url to the event info. |
location |
The location where the event is happening, or an organization is located. |
eventCharacters[] |
The characters related to this event. It can be directors or actors of a movie event, or performers of a concert, etc. |
startDate |
Start time. |
endDate |
End time. |
doorTime |
Entry time, which might be different from the event start time. e.g. the event starts at 9am, but entry time is 8:30am. |
EventCharacter
One event character, e.g. organizer, performer etc.
JSON representation | |
---|---|
{ "type": enum ( |
Fields | |
---|---|
type |
type of the event character, e.g. actor or director. |
name |
name of the character. |
image |
Character's images. |