Skip to content
Sviluppatori

API per carte wallet

Un'unica API per creare, aggiornare e revocare carte Apple Wallet e Google Wallet con webhook per eventi in tempo reale.

  • API REST e webhook
  • Apple Wallet + Google Wallet
  • Modelli, emissione batch e sandbox
Compatibile con:
Apple WalletApple WalletGoogle WalletGoogle Wallet

Esplora API REST Passinstance

Esempio illustrativo

Richieste e risposte di esempio. Non viene inviata alcuna chiamata API.

POST/api/v1/passes
Emetti un pass personalizzato per Apple Wallet e Google Wallet con link di download diretti.
curl -X POST https://api.passinstance.com/api/v1/passes \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "customFields": {
      "customerName": { "label": "MEMBER", "value": "Jane Doe" },
      "pointsBalance": { "label": "POINTS", "value": "1,450 pts" },
      "tier": { "label": "TIER", "value": "Gold VIP" }
    },
    "barcodeMessage": "PASS-MEM-2026-8819"
  }'
Risposta di esempio
201 Created
{
  "ok": true,
  "data": {
    "id": "pass_9842011a",
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "status": "active",
    "downloadUrl": "https://api.passinstance.com/api/v1/passes/pass_9842011a/download",
    "googleWalletUrl": "https://pay.google.com/gp/v/save/eyJhbGciOiJSUzI1...",
    "applePassUrl": "https://passinstance.com/p/pass_9842011a.pkpass",
    "createdAt": "2026-08-16T15:25:00Z"
  }
}
Panoramica

Passinstance offre un'API per automatizzare l'intero ciclo di vita delle carte: emissione da modelli, aggiornamento di campi e codici a barre, notifiche push e revoca.

I webhook inviano notifiche in tempo reale a server, CRM o registratori di cassa a ogni installazione o scansione.

Funzionalità

Tutto per distribuire le tue carte Wallet in produzione

01

Endpoint per l'intero ciclo di vita

Crea, leggi, aggiorna e revoca carte con endpoint REST predicibili.

02

Webhook per eventi in tempo reale

Ricevi eventi di installazione, aggiornamento e riscatto senza polling continuo.

03

API per carte wallet

Crea, aggiorna e revoca carte a livello di codice con un'API REST e webhook per eventi in tempo reale.

04

Codici QR e link di download

Distribuisci carte tramite pagine web dedicate, codici QR, email, SMS o POS — installazione con un tocco senza app.

05

Aggiornamenti specifici del wallet

Aggiorna i dati via API. Apple Wallet può mostrare messaggi configurati; Google controlla gli avvisi integrati.

06

Rilevanza geografica

Configura luoghi per le funzioni supportate. Disponibilità, visualizzazione e permessi dipendono dal wallet e dalle impostazioni del cliente.

07

Date, scadenza e ciclo di vita

Imposta date di scadenza, estendi la validità alla scansione e gestisci l'intero ciclo di vita della carta.

FAQ

Domande frequenti

Cosa permette di fare l'API carte wallet?

Crea, aggiorna e revoca pass Apple Wallet e Google Wallet via API. Apple Wallet usa APNs per gli aggiornamenti; Google gestisce gli avvisi integrati. L'API offre anche modelli e webhook per gli eventi dei pass.

È un'unica API per Apple e Google?

Sì. Con un'unica chiamata crei carte per entrambi i sistemi operativi.

L'API include i webhook?

Sì. Notifiche immediate per tutte le azioni dell'utente.

C'è un ambiente di test?

Sì. Sandbox completa con chiavi API di prova.

PROVA PASS DI PRODUZIONE SUL TUO DISPOSITIVO

Scansiona pass reali direttamente in Apple Wallet e Google Wallet

Inquadra con la fotocamera del tuo smartphone uno dei codici QR qui sotto per installare all'istante un pass verificato. Prova le notifiche push su schermata di blocco e l'integrazione nativa senza scaricare app.

Apple WalletGoogle WalletApple Wallet e Google Wallet
Private banking
Aurelia Private Bank - Private Client Cashback & Concierge
Esperienza dal vivo

Prova il pass live di Aurelia Private Bank

Mostra il cashback in tempo reale e lo stato del servizio concierge 24/7 in filiale o al POS, senza un’altra app bancaria.

ClienteAlexander Wright
Cashback€428.50
Conto•••• 9104

Pass demo interattivi per Apple Wallet e Google Wallet

Crea questa esperienza Wallet nel tuo spazio di lavoro

Inizia gratis mantenendo questo contesto demo per ricevere subito il modello corrispondente durante l'onboarding.

Inizia a costruire con l'API carte wallet

Inizia gratis, ottieni le chiavi API e automatizza le tue carte mobili con i webhook.