Skip to content
OFFICIAL STEP-BY-STEP GUIDE
ChatGPT, Claude & Gemini

How to Create Apple & Google Wallet Passes with AI

Learn how to use ChatGPT, Claude, and Gemini to generate Wallet pass JSON specs, export unsigned .pkpass assets, and import them into Passinstance for cryptographic signing and hosted delivery.

5-Step AI-to-Wallet Pipeline

Jump straight to any stage or generate your prompt inside Studio.

01 → 05
Zero-Trust HSM Signing — Apple .p12 keys stay inside Passinstance
ARCHITECTURE OVERVIEW

Why Combine Generative AI with Passinstance?

Generative AI models like ChatGPT, Claude, and Gemini excel at structuring visual layouts, designing cohesive color palettes, and drafting copy. However, Apple Wallet and Google Wallet require rigorous JSON schema conformity, precise image aspect ratios, and cryptographically verified digital signatures signed with Apple Developer certificates.

Passinstance bridges this gap: our AI prompt generator provides the exact Apple Wallet field schema to your AI tool. You simply export an unsigned .pkpass package, and Passinstance automatically parses the dynamic placeholders, adapts the layout for Google Wallet, and handles cryptographic signing securely during issuance.

The Zero-Trust Boundary: Never Share Private Keys with AI

External AI chat tools should never receive your Apple Developer certificates (.p12, .pem), Pass Type IDs, or private signing keys. With Passinstance, external AI only outputs the structural design package (.pkpass with pass.json and image assets). Passinstance signs your passes inside secure, isolated HSM environments upon live delivery.

01

Step 1: Select Pass Category & Brand Identity

Open the Create Wallet Pass with AI modal in Passinstance Dashboard. Choose from the 6 standard Apple Wallet pass styles:

Loyalty & Store Card

Points balance, membership tiers, and store check-in.

Membership Card

Member IDs, expiry dates, and association status.

Event Ticket & Poster Pass

Admission levels, seat rows, dates, and venue barcodes.

Discount Coupon & Boarding Pass

Special offers, flights, gates, and seat numbers.

Tip: Define your Background, Text (Foreground), and Label colors. Passinstance automatically converts hex codes into standard Apple Wallet rgb(r, g, b) strings.

Zoomed UI focus
Key UI elements

AI Pass Wizard — Category & Brand Identity

Select Loyalty & Store Card, Membership Card, Poster Pass, Event Ticket, Discount Coupon, or Boarding Pass and configure brand colors converted automatically to Apple rgb(r, g, b).

02

Step 2: Generate & Run the Prompt in AI Chat

Passinstance generates an AI-optimized specification. Launch your preferred AI tool using the quick links directly in the dashboard:

Choose pass preset:

Sample Generated PromptstoreCard
{firstName}{points}{tierName}{memberId}
You are an expert Apple Wallet pass architect.
Create an unsigned .pkpass design package (pass.json + PNG artwork placeholders) configured as a Passinstance "storeCard" Loyalty Pass:

- formatVersion: 1, passTypeIdentifier & teamIdentifier left as placeholders (signed server-side by Passinstance HSM)
- Colors (strict rgb format): backgroundColor "rgb(16, 26, 35)", foregroundColor "rgb(255, 255, 255)", labelColor "rgb(125, 180, 240)"
- headerFields: key "tier", label "STATUS", value "{tierName}", changeMessage "Your status is now %@"
- primaryFields: key "points", label "POINTS", value "{points}", changeMessage "Points updated to %@!"
- secondaryFields: key "member", label "MEMBER", value "{firstName}"
- auxiliaryFields: key "cardNo", label "CARD ID", value "{memberId}"
- barcode: PKBarcodeFormatQR with message "{memberId}" and iso-8859-1 encoding

Important: Use single curly braces ({variable}) for dynamic attributes so Passinstance auto-detects Custom Properties during .pkpass import. Do not include certificates or signatures.
rgb(16, 26, 35)rgb(255, 255, 255)rgb(125, 180, 240)

Key Syntax Elements:

{firstName} · {points}

Single Curly Braces

Dynamic placeholders like {firstName} or {points} are automatically discovered during import.

changeMessage

changeMessage Strings

Fields include push message templates like "Your points updated to %@!" for real-time lockscreen banners.

PKBarcodeFormatQR

Barcode Object

Standardized to PKBarcodeFormatQR with ISO-8859-1 message encoding.

Zoomed UI focus
Key UI elements

AI Pass Wizard — Mechanics, Triggers & Placeholders

Pre-select geofencing, expiration rules, pass mechanics, and dynamic {token} placeholders before generating your prompt.

Zoomed UI focus
Key UI elements

AI Pass Wizard — Prompt Launch & Security Safeguard

Open the generated prompt directly in ChatGPT, Claude, or Gemini while keeping your Apple Developer private keys strictly offline.

03

Step 3: Export the Unsigned .pkpass Package

Instruct your AI tool to provide the package files. A standard Apple Wallet .pkpass archive contains the following structure:

.pkpass Package Anatomy

my-wallet-pass.pkpass (ZIP archive)

ZIP / Unsigned
  • pass.jsonJSON Schema
  • icon.png · icon@2x.pngPNG Assets
  • logo.png · logo@2x.pngPNG Assets
  • strip.png · strip@2x.pngPNG Assets
  • (optional) en.lproj/pass.stringsL10n Strings

Packaging rule: Ensure the archive is saved as .pkpass. Passinstance inspects the package, validates JSON syntax, and prepares assets for cross-platform rendering.

Zoomed UI focus
Key UI elements

AI Pass Wizard — Artwork Links & Upload Options

Supply HTTPS artwork links in the prompt or drag-and-drop PNG assets directly into your AI conversation to bundle them into the unsigned .pkpass archive.

04

Step 4: Import into Passinstance & Auto-Detect Attributes

In the Passinstance Dashboard, click Upload Design Package (.pkpass). The Smart Package Parser automatically:

Discovers Dynamic Tokens: Extracts every {placeholder} and registers it as a custom customer attribute.
Infers Data Types: Classifies fields into Text, Number, Date, Currency, or Barcode values.
Dual-Wallet Mapping: Automatically adapts the Apple Wallet layout into a native Google Wallet class and object.
Zoomed UI focus
Key UI elements

Templates Toolbar — Import .pkpass / JSON

Open New template → Import from file to upload your AI-generated .pkpass package, ZIP archive, or JSON template export.

Zoomed UI focus
Key UI elements

Visual Editor — Auto-Detected Custom Properties

Review every extracted placeholder from your imported package, tighten validation flags, or bind variables via '{' autocomplete.

05

Step 5: Publish, Sign & Distribute Live Passes

Once reviewed, publish your template. You can now issue live, signed passes through your preferred channel:

REST API

Issue via POST /api/v1/passes with customer JSON payload.

Bulk CSV Import

Import thousands of customer rows with mapped attributes.

Web PassFlow

Branded self-service PassFlow pages for direct wallet add.

Zoomed UI focus
Key UI elements

Template Overview — Publishing Checklist (3 of 3 Ready)

Confirm Signing certificate, Validation rules, and Download page all report Ready before distributing passes.

Zoomed UI focus
Key UI elements

Published Template Header & Single-Pass / Batch Actions

Once Ready, immediately create test passes, send bulk email/SMS campaigns, or manage production Apple signing certificates.

FREQUENTLY ASKED QUESTIONS

Frequently Asked Questions

Can I use free versions of ChatGPT, Claude, or Gemini?

Yes. The generated prompt uses standard JSON and plain English instructions. Free versions of ChatGPT (GPT-4o mini / GPT-4o), Claude 3.5 Sonnet, and Gemini 1.5 Flash all produce compliant pass.json specifications.

Do I need an Apple Developer account before testing with AI?

No. You can design, import, and test passes immediately in your Passinstance sandbox environment. When you are ready to deploy to production, you can upload your Apple Developer certificate to your Passinstance workspace settings.

How does Passinstance convert Apple Wallet designs into Google Wallet passes?

Passinstance automatically maps Apple Wallet fields (headerFields, primaryFields, secondaryFields) to corresponding Google Wallet class definitions and object text modules. The design appears native on both iOS and Android.

Ready to launch passes with AI?

Generate your first production-ready Apple and Google Wallet pass in minutes using ChatGPT, Claude, or Gemini.