REST Resource: loyaltyclass

Resource: LoyaltyClass

JSON representation
{
  "kind": string,
  "programName": string,
  "programLogo": {
    object (Image)
  },
  "accountNameLabel": string,
  "accountIdLabel": string,
  "rewardsTierLabel": string,
  "rewardsTier": string,
  "localizedProgramName": {
    object (LocalizedString)
  },
  "localizedAccountNameLabel": {
    object (LocalizedString)
  },
  "localizedAccountIdLabel": {
    object (LocalizedString)
  },
  "localizedRewardsTierLabel": {
    object (LocalizedString)
  },
  "localizedRewardsTier": {
    object (LocalizedString)
  },
  "secondaryRewardsTierLabel": string,
  "localizedSecondaryRewardsTierLabel": {
    object (LocalizedString)
  },
  "secondaryRewardsTier": string,
  "localizedSecondaryRewardsTier": {
    object (LocalizedString)
  },
  "discoverableProgram": {
    object (DiscoverableProgram)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  }
}
Fields
kind
(deprecated)

string

Identifies what kind of resource this is. Value: the fixed string "walletobjects#loyaltyClass".

programName

string

The program name, such as "Adam's Apparel". The app may display an ellipsis after the first 20 characters to ensure full string is displayed on smaller screens.

accountNameLabel

string

The account name label, such as "Member Name." Recommended maximum length is 15 characters to ensure full string is displayed on smaller screens.

accountIdLabel

string

The account ID label, such as "Member ID." Recommended maximum length is 15 characters to ensure full string is displayed on smaller screens.

rewardsTierLabel

string

The rewards tier label, such as "Rewards Tier." Recommended maximum length is 9 characters to ensure full string is displayed on smaller screens.

rewardsTier

string

The rewards tier, such as "Gold" or "Platinum." Recommended maximum length is 7 characters to ensure full string is displayed on smaller screens.

localizedProgramName

object (LocalizedString)

Translated strings for the programName. The app may display an ellipsis after the first 20 characters to ensure full string is displayed on smaller screens.

localizedAccountNameLabel

object (LocalizedString)

Translated strings for the accountNameLabel. Recommended maximum length is 15 characters to ensure full string is displayed on smaller screens.

localizedAccountIdLabel

object (LocalizedString)

Translated strings for the accountIdLabel. Recommended maximum length is 15 characters to ensure full string is displayed on smaller screens.

localizedRewardsTierLabel

object (LocalizedString)

Translated strings for the rewardsTierLabel. Recommended maximum length is 9 characters to ensure full string is displayed on smaller screens.

localizedRewardsTier

object (LocalizedString)

Translated strings for the rewardsTier. Recommended maximum length is 7 characters to ensure full string is displayed on smaller screens.

secondaryRewardsTierLabel

string

The secondary rewards tier label, such as "Rewards Tier."

localizedSecondaryRewardsTierLabel

object (LocalizedString)

Translated strings for the secondaryRewardsTierLabel.

secondaryRewardsTier

string

The secondary rewards tier, such as "Gold" or "Platinum."

localizedSecondaryRewardsTier

object (LocalizedString)

Translated strings for the secondaryRewardsTier.

discoverableProgram

object (DiscoverableProgram)

Information about how the class may be discovered and instantiated from within the Google Pay app.

id

string

The unique identifier for a class. This ID must be unique across all classes from an issuer. This value should follow the format issuer ID.identifier where the former is issued by Google and latter is chosen by you. Your unique identifier should only include alphanumeric characters, '.', '_', or '-'.

version
(deprecated)

string (int64 format)

Deprecated

issuerName

string

The issuer name. Recommended maximum length is 20 characters to ensure full string is displayed on smaller screens.

messages[]

object (Message)

An array of messages displayed in the app. All users of this object will receive its associated messages. The maximum number of these fields is 10.

allowMultipleUsersPerObject
(deprecated)

boolean

Deprecated. Use multipleDevicesAndHoldersAllowedStatus instead.

homepageUri

object (Uri)

The URI of your application's home page. Populating the URI in this field results in the exact same behavior as populating an URI in linksModuleData (when an object is rendered, a link to the homepage is shown in what would usually be thought of as the linksModuleData section of the object).

locations[]

object (LatLongPoint)

The list of locations where the object can be used. The platform uses this information to trigger geolocated notifications to users. Note that locations in the object override locations in the class which override locations in the Google Places ID.

reviewStatus

enum (ReviewStatus)

The status of the class. This field can be set to draft or underReview using the insert, patch, or update API calls. Once the review state is changed from draft it may not be changed back to draft.

You should keep this field to draft when the class is under development. A draft class cannot be used to create any object.

You should set this field to underReview when you believe the class is ready for use. The platform will automatically set this field to approved and it can be immediately used to create or migrate objects.

When updating an already approved class you should keep setting this field to underReview.

review

object (Review)

The review comments set by the platform when a class is marked approved or rejected.

infoModuleData
(deprecated)

object (InfoModuleData)

Deprecated. Use textModulesData instead.

imageModulesData[]

object (ImageModuleData)

Image module data. If image modules data is also defined on the object, those will be merged with the image data defined on the class. The maximum number of these fields (combined with the object) is 1.

textModulesData[]

object (TextModuleData)

Text module data. If text modules data is also defined on the object, both will be displayed. The maximum number of these fields (combined with the object) is 10.

redemptionIssuers[]

string (int64 format)

Available only to Smart Tap enabled partners. Contact support for additional guidance.

countryCode

string

Country code used to display the card's country (when the user is not in that country), as well as to display localized content when content is not available in the user's locale.

heroImage

object (Image)

Optional banner image displayed on the front of the card. If none is present, nothing will be displayed. The image will display at 100% width.

wordMark
(deprecated)

object (Image)

Deprecated.

enableSmartTap

boolean

Available only to Smart Tap enabled partners. Contact support for additional guidance.

hexBackgroundColor

string

The background color for the card. If not set the dominant color of the hero image is used, and if no hero image is set, the dominant color of the logo is used. The format is #rrggbb where rrggbb is a hex RGB triplet, such as #ffcc00. You can also use the shorthand version of the RGB triplet which is #rgb, such as #fc0.

localizedIssuerName

object (LocalizedString)

Translated strings for the issuerName. Recommended maximum length is 20 characters to ensure full string is displayed on smaller screens.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Identifies whether multiple users and devices will save the same object referencing this class.

callbackOptions

object (CallbackOptions)

Callback options to be used to call the issuer back for every save/delete of an object for this class by the end-user. All objects of this class are eligible for the callback.

DiscoverableProgram

Information about how a class may be discovered and instantiated from within the Android Pay app. This is done by searching for a loyalty or gift card program and scanning or manually entering.

JSON representation
{
  "merchantSignupInfo": {
    object (DiscoverableProgramMerchantSignupInfo)
  },
  "merchantSigninInfo": {
    object (DiscoverableProgramMerchantSigninInfo)
  },
  "state": enum (State)
}
Fields
merchantSignupInfo

object (DiscoverableProgramMerchantSignupInfo)

Information about the ability to signup and add a valuable for this program through a merchant site. Used when MERCHANT_HOSTED_SIGNUP is enabled.

merchantSigninInfo

object (DiscoverableProgramMerchantSigninInfo)

Information about the ability to signin and add a valuable for this program through a merchant site. Used when MERCHANT_HOSTED_SIGNIN is enabled.

state

enum (State)

Visibility state of the discoverable program.

DiscoverableProgramMerchantSignupInfo

Information about the merchant hosted signup flow for a program.

JSON representation
{
  "signupWebsite": {
    object (Uri)
  },
  "signupSharedDatas": [
    enum (SharedDataType)
  ]
}
Fields
signupWebsite

object (Uri)

The URL to direct the user to for the merchant's signup site.

signupSharedDatas[]

enum (SharedDataType)

User data that is sent in a POST request to the signup website URL. This information is encoded and then shared so that the merchant's website can prefill fields used to enroll the user for the discoverable program.

SharedDataType

Enums
SHARED_DATA_TYPE_UNSPECIFIED
FIRST_NAME
LAST_NAME
STREET_ADDRESS single line address field
ADDRESS_LINE_1 multi line address fields
ADDRESS_LINE_2
ADDRESS_LINE_3
CITY
STATE
ZIPCODE
COUNTRY
EMAIL
PHONE

DiscoverableProgramMerchantSigninInfo

Information about the merchant hosted signin flow for a program.

JSON representation
{
  "signinWebsite": {
    object (Uri)
  }
}
Fields
signinWebsite

object (Uri)

The URL to direct the user to for the merchant's signin site.

State

Enums
STATE_UNSPECIFIED
TRUSTED_TESTERS Visible only to testers that have access to issuer account.
trustedTesters

Legacy alias for TRUSTED_TESTERS. Deprecated.

LIVE Visible to all.
live

Legacy alias for LIVE. Deprecated.

DISABLED Not visible.
disabled

Legacy alias for DISABLED. Deprecated.

Methods

addmessage

Adds a message to the loyalty class referenced by the given class ID.

get

Returns the loyalty class with the given class ID.

insert

Inserts an loyalty class with the given ID and properties.

list

Returns a list of all loyalty classes for a given issuer ID.

patch

Updates the loyalty class referenced by the given class ID.

update

Updates the loyalty class referenced by the given class ID.