Developers

Developer docs

Issue a test pass in a quarter of an hour: sandbox key, one event, one add-to-wallet link.

Quickstart

  1. Open a sandbox and sign in to the console with a passkey.
  2. Create an API key on Developers. Copy it once.
  3. POST /v1/passes with holder_ref and template. You get a signed add-to-wallet link.
  4. POST /v1/events when your source of truth changes. Use an Idempotency-Key.

Contract and SDKs

  • OpenAPI 3.1: API overview and the contract in the repository at docs/api/openapi.yaml
  • PHP SDK: packages/sdk-php (webhook verification included)
  • TypeScript SDK: packages/sdk-ts
  • Webhook signature vectors: examples/webhooks

Rules that save time

  • Scoped keys. Live keys cannot be created on a sandbox.
  • Problem details (RFC 9457) on errors.
  • The field map is config. Do not encode tenant logic in your client.
  • We display your figures. We never compute money.

Need a walkthrough? Ask a developer question.