Gift cards pass builder

Use the interactive Expressive Pass Builder on this page to customize your pass, preview Lighter and Darker background tones, and generate REST API v1 JSON and JWT payloads for Google Wallet.

subtitles Form

data_object JSON

1. Pass Appearance & Branding Edge-to-Edge Surface

Background color (class.hexBackgroundColor) — Click swatch to pick or type hex code

Merchant name (class.localizedMerchantName) Card balance headline (object.balance)

Circular program logo URL (class.programLogo — 36px rounded square) Wide program logo URL (class.wideProgramLogo — replaces 3-part header)

Hero image banner URL (class.heroImage — full-bleed banner between Card Face & Details)

2. Card Face Barcode & App Link Pill Button Card Face

Barcode type (object.barcode.type) Barcode payload value (object.barcode.value)

Barcode alternate text (object.barcode.alternateText) App Link button text (object.appLinkData.displayText)

Android package name (androidAppLinkInfo.appTarget.packageName) Fallback web URI (webAppLinkInfo.appTarget.targetUri.uri)

3. Card Face Last Updated & Gift Card Details Card Face + Bottom Sheet

Balance last updated (object.balanceUpdateTime — shown on Card Face) Gift card number (object.cardNumber)

PIN label (class.pinLabel) PIN code (object.pin)

Event number label (class.eventNumberLabel) Event number (object.eventNumber)

Gift cards pass builder

Object definition (`GiftCardObject` REST API v1)

Class definition (`GiftCardClass` REST API v1)

Gift cards pass builder

Object definition (GiftCardObject REST API v1)

Class definition (GiftCardClass REST API v1)

Object definition (`GiftCardObject` REST API v1)

Class definition (`GiftCardClass` REST API v1)