integrate-accessgrid

Integrates AccessGrid mobile wallet credentials into an existing host codebase through eight phased steps.

Updated May 9, 2026
One-click install
npx skills add https://github.com/Access-Grid/skills --skill integrate-accessgrid-access-grid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integrate-accessgrid
Source: https://github.com/Access-Grid/skills/tree/main/skills/integrate-accessgrid
Command: npx skills add https://github.com/Access-Grid/skills --skill integrate-accessgrid-access-grid

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Adding Apple, Google, and Samsung wallet credentials to an existing product requires coordinating SDK selection, database schema changes, secrets management, billing wiring, lifecycle endpoints, and webhook handling — a process that is easy to get wrong (duplicate issuance, unencrypted tokens, missed webhook events) without a structured plan. ## Core Features & Use Cases - Eight-phase guided integration: language/SDK selection, design session (MVP / Essential / Complete / Premium levels plus UI/API choice and billing model), database discovery against four canonical concepts, migrations, secrets and client wiring, billing integration, endpoints and lifecycle, and webhook handling. - Per-language SDK references: install commands, client init, provisioning and lifecycle method signatures, webhook receivers, and encryption-at-rest patterns for JavaScript/TypeScript, Ruby, Go, Python, C#/.NET, Java, and PHP, plus a porting guide for stacks without an official SDK. - Snapshotted AccessGrid references: HMAC-SHA256 API authentication (X-ACCT-ID / X-PAYLOAD-SIG), pass state transitions, image dimension requirements, webhook event catalog, and billing patterns for Stripe, Spreedly, Authorize.net, Chargify, Adyen, and Checkout.com. - Use Case: A Rails SaaS team wants to issue mobile wallet access passes to its users. The skill walks them through picking the Essential level, mapping their users/credentials tables, adding accessgrid_id and state columns, wiring the Ruby SDK, and standing up a deduplicating webhook receiver. ## Quick Start Ask the agent to integrate AccessGrid mobile wallet credentials into your existing application and answer its questions about language, integration level, and billing model.

Frequently Asked Questions about integrate-accessgrid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate AccessGrid wallet credentials into my existing app?

Follow the eight phases in order: pick your language SDK, lock an integration level (MVP through Premium) and billing model, map the four canonical database concepts, run migrations, wire secrets and the client, connect billing, build lifecycle endpoints, and stand up the webhook receiver.

Which AccessGrid integration level should I choose: MVP, Essential, Complete, or Premium?

Essential is the recommended default: it adds database-managed card templates and webhooks on top of MVP's env-var-based issuance. Choose MVP for single-product hosts with no per-tenant customization, Complete for operator UIs with branding and credential profiles, and Premium when you also need landing pages and ledger items.

Does AccessGrid have an SDK for my language?

Official SDKs exist for JavaScript/TypeScript, Ruby, Go, Python, C#/.NET, Java, and PHP. For other languages like Elixir, Rust, or Kotlin, port from the Python SDK using the HMAC-SHA256 signing spec with X-ACCT-ID and X-PAYLOAD-SIG headers.

How do I prevent duplicate credential issuance with AccessGrid?

Before calling provision, check whether the host credential already has an accessgrid_id and return the existing pass instead. Persist the returned ID transactionally, dedupe webhooks by event ID with a TTL of at least 7 days, and use deterministic idempotency keys on billing calls.

How do AccessGrid webhooks work and what events should I subscribe to?

Webhooks arrive as CloudEvents 1.0 with a bearer token; verify the token, validate specversion and source, dedupe by event ID, and always return {"received": true}. Subscribe to all ag.access_pass.* events plus ag.webhook.cert_expiring and ag.account_balance.low at MVP, adding card_template, credential_profile, and landing_page events at higher levels.

Can I bill customers for AccessGrid passes through my existing payment provider?

Yes — the skill wires AG lifecycle events into your existing Stripe, Spreedly, Authorize.net, Chargify, Adyen, or Checkout.com integration. Billing triggers from AG webhooks (not local state), uses the provider's native idempotency mechanism, and includes a daily reconciliation job.