Group multiple passes

  • Adding multiple passes to a single Google Wallet link will not group them by default, but you can group them using the same groupingId .

  • Grouped passes appear together in the Google Wallet app and can be provisioned together or grouped later using the update or patch methods.

  • To group passes, set the groupingInfo.groupingId property to the same value for all passes you want to group.

  • Passes with the same groupingId will be automatically grouped, even if added separately, and displayed in a carousel when selected.

Use a grouping ID

By default, adding multiple passes to a single Add to Google Walletlink will not group those passes in the user's Google Wallet app. However, passes can be grouped together by making sure they all have the same grouping ID. Grouped passes will appear together in the Google Wallet app. When a group of passes is selected, each pass will be shown on a carousel.

Passes can be grouped together:

To add a pass to a group, the groupingInfo.groupingId property of the pass object must be set. All pass objects with the same groupingId value will be automatically grouped together, even if they were added separately.

The following example shows a loyalty card and offer being grouped together to entice the user to make use of both in their next purchase.

 loyaltyObject 
  
 = 
  
 { 
  
 "classId" 
 : 
  
 "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX" 
 , 
  
 "id" 
 : 
  
 "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX" 
 , 
  
 "state" 
 : 
  
 "ACTIVE" 
 , 
  
 "groupingInfo" 
 : 
  
 { 
  
 # 
  
 Note 
  
 the 
  
 same 
  
 groupingId 
  
 value 
  
 "groupingId" 
 : 
  
 "combinedGiftCardAndOfferId" 
 , 
  
 "sortIndex" 
 : 
  
 1 
  
 }, 
  
 "barcode" 
 : 
  
 { 
  
 "type" 
 : 
  
 "QR_CODE" 
 , 
  
 "value" 
 : 
  
 "QR code" 
  
 }, 
  
 "accountId" 
 : 
  
 "Account id" 
 , 
  
 "accountName" 
 : 
  
 "Account name" 
 , 
  
 "loyaltyPoints" 
 : 
  
 { 
  
 "label" 
 : 
  
 "Points" 
 , 
  
 "balance" 
 : 
  
 { 
  
 "int" 
 : 
  
 800 
  
 } 
  
 } 
 } 
 offerObject 
  
 = 
  
 { 
  
 "classId" 
 : 
  
 "ISSUER_ID.OFFER_CLASS_SUFFIX" 
 , 
  
 "id" 
 : 
  
 "ISSUER_ID.OFFER_OBJECT_SUFFIX" 
 , 
  
 "state" 
 : 
  
 "ACTIVE" 
 , 
  
 "groupingInfo" 
 : 
  
 { 
  
 # 
  
 Note 
  
 the 
  
 same 
  
 groupingId 
  
 value 
  
 "groupingId" 
 : 
  
 "combinedGiftCardAndOfferId" 
 , 
  
 "sortIndex" 
 : 
  
 2 
  
 }, 
  
 "barcode" 
 : 
  
 { 
  
 "type" 
 : 
  
 "QR_CODE" 
 , 
  
 "value" 
 : 
  
 "QR code" 
 , 
  
 }, 
 } 
Create a Mobile Website
View Site in Mobile | Classic
Share by: