SGC
SGC TECH AIDIGITAL CREDENTIAL

Digital Credential

A premium digital identity that lives in your phone — Apple Wallet, Google Wallet, QR sharing, and vCard export for executives and enterprise.

Demo Mode — Ready for User Testing

All features work end-to-end. The QR code, vCard download, public profile, verification page, and admin dashboard are fully functional. The Apple Wallet and Google Wallet buttons generate valid file structures but will not install on real phones without production certificates — you can still download and inspect the .pkpass file and view the Google Wallet payload.

See the Testing Guide below for a step-by-step walkthrough.

Apple + Google WalletValid file structures (no install in demo)
QR SharingFully working — scan to view
vCard ExportFully working — opens in Contacts
VerifiedVerification page live
Testing Guide — Step by Step
Everything below works without any certificates. Try each step on a desktop or mobile browser.
1

Open a demo credential profile

Tap any credential above to see the premium mobile-first digital business card with photo, contact buttons, and verification status.

Open Renbran Madelo's credential
2

Tap Save Contact to download a .vcf vCard

The vCard file will download. Open it on your phone or desktop — it imports cleanly into iOS Contacts, Google Contacts, Outlook, and any vCard-compatible app.

Try it — open profile, tap Save Contact
3

Tap Show QR to display the QR code

The QR dialog opens with an embedded QR image. Scan it with another phone's camera — it opens the public profile on that device.

Try it — open profile, tap Show QR
4

Visit the Verification page

The verification page shows the credential status (Active/Suspended/Revoked/Expired), holder, organization, issuer, and verification URL — public proof of validity.

View verification page
5

Open the Admin Dashboard

Log in with the demo admin token (pre-filled in the form). You can edit credentials, change visibility per field, revoke/reactivate, create new people and companies, and view the audit log.

Open Admin (token: sgc-admin-dev-token-change-me)
6

Test Apple Wallet (download the .pkpass file)

On a profile page, tap Add to Apple Wallet (mobile) or use the link below to download the .pkpass file. It's a valid ZIP archive with pass.json, icon.png, and manifest.json. iOS won't install it without a production Apple Developer certificate, but you can inspect the structure.

Download .pkpass file
7

Test Google Wallet (view the JSON payload)

The Google Wallet endpoint returns the pass object structure as JSON. Without a Google service account configured, the save URL is null and a clear DEVELOPMENT MODE notice is returned — that's expected.

View Google Wallet JSON payload
8

Test revoke & reactivate flow

In the Admin Dashboard, click Revoke on any credential. The public profile, vCard endpoint, Apple/Google Wallet endpoints all return 410 Gone with a clear message. Click Reactivate to restore.

Open Admin to test revoke
About Apple & Google Wallet Certificates
You do not need these for testing. Read this when you're ready to go to production.

Apple Wallet — Apple Developer Program

To enable real installation on iPhones, you need an Apple Developer Program membership ($99/year) and a Pass Type ID certificate from Apple. The system is built to use these automatically once you set the environment variables — there is no code change needed.

Required env vars: APPLE_TEAM_ID, APPLE_PASS_TYPE_IDENTIFIER, APPLE_CERTIFICATE (path to .p12), APPLE_CERTIFICATE_PASSWORD, APPLE_WWDR_CERTIFICATE. See .env.example for the full list.

Google Wallet — Google Cloud Platform

To enable real installation on Android phones, you need a Google Cloud Platform project with the Google Wallet API enabled, a Wallet issuer account, and a service account JSON key. Same as Apple — once you set the env vars, the system handles signing automatically.

Required env vars: GOOGLE_ISSUER_ID, GOOGLE_SERVICE_ACCOUNT (JSON string) or GOOGLE_SERVICE_ACCOUNT_PATH (file path). See .env.example for details.

When you're ready: The README.md file contains full step-by-step checklists for obtaining Apple and Google certificates, including the exact commands to convert .p12 to PEM and the Google Wallet API class-creation curl command.
About the system
Four technologies, one canonical source of truth.

The SGC Tech AI Digital Credential System unifies four separate layers — a digital web credential, a PWA, an Apple Wallet pass, and a Google Wallet pass — around a single backend credential record.

  • Each credential has a permanent ID — the QR code stays stable even when contact information changes.
  • Public profile pages respect per-field visibility controls (Public, Wallet, Contact export, Private).
  • Save Contact generates a valid RFC 6350 vCard that opens correctly in iOS, Android, Outlook, and Google Contacts.
  • Apple Wallet passes use the official PassKit specification; Google Wallet passes use the official save-to-wallet JWT.
  • Admins can create, edit, suspend, revoke, and reactivate credentials — with full audit logging.