Skip to content
Guida del Centro assistenza · Programma non profit
3 min di letturaVerificato 2026-11-16

Richieste e supporto

Invia una richiesta associativa, prepara i documenti dell'ente e assegna accessi scanner ai volontari.

In questa guida

Flusso di candidatura e onboarding per il programma Non-Profit

Le associazioni senza scopo di lucro, le istituzioni culturali e gli enti di beneficenza registrati possono richiedere condizioni commerciali dedicate e un onboarding guidato tramite il modulo di richiesta Pilot di Passinstance (/pilot utilizzando PilotRequestForm, che invia { intent: "pilot", useCase: "nonprofit", ... } a /api/contact) oppure tramite /contact (POST /api/v1/contact gestito da Support Intake API).

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
CANDIDATURA E ONBOARDING NON-PROFIT
FASE 01
1
INVIO DELLA CANDIDATURA (/pilot o POST/api/v1/contact)
Il richiedente invia PilotRequestForm (intent: "pilot", `useCase:
"nonprofit"orequest payload{ name, email, company?, message }`)
FASE 02
2
VERIFICA E CONFIGURAZIONE COMMERCIALE
Il team operativo verifica lo stato di registrazione dell'ente non-profit
Attiva un PricingAgreement personalizzato o un BillingPromotionCode
FASE 03
3
CREAZIONE DEI MODELLI E DISTRIBUZIONE DELLO SCANNER PER I VOLONTARI
Configura modelli di tessere/biglietti e importa i CSV dei sostenitori
Associa gli smartphone dei volontari tramite POST/api/v1/scanner-keys/from-link

Invio della candidatura per organizzazioni Non-Profit

Può inviare la Sua candidatura attraverso il modulo interattivo /pilot (intent: "pilot", useCase: "nonprofit") o tramite /contact (Support Intake API POST /api/v1/contact):

Percorso EndpointMetodoAutenticazioneFunzionalità
/api/v1/contactPOSTPubblicoInvia una richiesta per l'organizzazione o di onboarding non-profit (request payload, limitato a 5 richieste/min).
/api/v1/billing/subscriptionGETBearerRestituisce l'abbonamento attivo del workspace (subscription status) e le condizioni del PricingAgreement associato una volta attivato.
/api/v1/scanner-keys/for-configPOSTBearer (scans:read)Genera chiavi scanner con ambito limitato per i dispositivi di check-in dei volontari senza concedere l'accesso di amministratore.

Dettagli richiesti nel payload della candidatura (request payload)

Includa il Suo codice identificativo di registrazione legale, il volume previsto di pass attivi e le tempistiche di lancio in POST /api/v1/contact:

JSON
{
  "name": "Clara Moreau",
  "email": "clara.moreau@heritagemuseum.example.org",
  "company": "European Heritage Museum Foundation (RNA W751234567)",
  "message": "Nonprofit Program Application — 4,500 active annual members, museum door QR check-in + annual expiration renewal. Target launch: October 1."
}

Risposta (201 Created):

JSON
{
  "ok": true,
  "id": "msg_019332c1-4400-7b11-9e22-112233445566"
}

Lista di controllo per un'approvazione rapida

  1. 1
    Ragione sociale e identificativo di registrazione: nome ufficiale dell'organizzazione, Paese di registrazione e numero di iscrizione al registro degli enti del terzo settore o delle associazioni (ad esempio, RUNTS in Italia, IRS EIN, UK Charity Commission, RNA francese o numero Vereinsregister tedesco).
  2. 2
    Identificativo del workspace (customerId): crei prima un workspace gratuito su Passinstance e includa l'indirizzo email dell'account del workspace in modo che il nostro team possa associare il PricingAgreement direttamente al Suo tenant.
  3. 3
    Volume di pass attivi nel wallet rispetto alla dimensione totale del database: specifichi quanti soci o volontari installeranno attivamente i pass in Apple Wallet o Google Wallet durante i mesi di picco.
  4. 4
    Flusso di check-in e rinnovo: indichi se convaliderà i pass utilizzando l'app mobile Passinstance Scanner, lettori ottici POS o link di rinnovo self-service.

Abilitazione sicura dei team di volontari per il check-in

Gli eventi non-profit, le assemblee generali dei soci e gli ingressi museali si affidano frequentemente a volontari temporanei o personale stagionale per scansionare i pass dei soci all'ingresso.

Importante: Non condivida mai le credenziali di Amministratore del workspace con i volontari degli eventi. Configuri invece un profilo ScannerConfiguration dedicato e distribuisca un link di associazione a scadenza temporale (POST /api/v1/scanner-keys/from-link) protetto da un PIN operatore (POST /api/v1/scanner-keys/unlock-pin). I volontari potranno convalidare i pass e registrare le presenze senza accedere alle esportazioni dei soci, ai modelli o alle impostazioni di fatturazione.

Esplori gli schemi architetturali per le tessere associative nella pagina Tessere associative per enti non-profit, richieda una configurazione guidata su /pilot o contatti il nostro team su /contact.

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.