❓ FAQ

Domande Generali

Q: Qual è la differenza tra modalità Standard e SSO?
A: La modalità Standard è deprecata e supporta solo salabam.com. La modalità SSO è l'unica attualmente supportata e permette l'accesso a tutti gli 8 portali.

Q: Posso testare in produzione?
A: No, utilizzate sempre staging per i test. Alcuni servizi (Travel Welfare, Voli) non sono reversibili in produzione.

Q: Come gestisco i rimborsi?
A: I rimborsi devono essere gestiti tramite il supporto Salabam. Non è possibile annullare ordini già confermati via API.

Domande Tecniche

Q: Qual è il timeout massimo per le callback?
A: 25 secondi. Ottimizzate le query e usate cache quando possibile.

Q: Posso usare lo stesso endpoint per auth e confirm?
A: Tecnicamente sì, ma sconsigliato. Usate endpoint separati per migliore tracciabilità.

Q: Come gestisco la doppia conferma?
A: Congelate il credito su orderAuthUrl, addebitatelo su orderConfirmUrl, rilasciatelo su orderRevokeUrl.

Q: Come funzionano i beneficiari?
A: Tre modalità: campo omesso (libero), oggetto vuoto (solo employee), array (lista specifica).

Domande Commerciali

Q: Quali sono le commissioni?
A: Contattate il commerciale Salabam per dettagli sul revenue sharing.

Q: Posso customizzare il portale?
A: Sì, tramite il campo customizations potete aggiungere logo e colori aziendali.

Q: È disponibile una dashboard?
A: Sì, è disponibile una dashboard completa con analytics in tempo reale.

Domande Integrazione

Q: Quanto tempo serve per l'attivazione?
A: L'ambiente staging è disponibile immediatamente, la produzione in 48 ore.

Q: Devo implementare tutti i servizi?
A: No, potete attivare solo i servizi che vi interessano.

Q: È compatibile con i principali CMS?
A: Sì, abbiamo plugin per WordPress, Drupal e moduli per i principali framework.

Q: Supportate l'SSO inverso?
A: Attualmente supportiamo solo SSO in uscita (dal vostro sistema ai nostri portali).

Domande Beneficiari

Q: Cosa succede se ometto il campo beneficiaries?
A: Il dipendente potrà inserire liberamente i dati di un beneficiario durante il checkout.

Q: Come faccio a permettere solo al dipendente di usufruire del servizio?
A: Passa "beneficiaries": {} (oggetto vuoto) nel JWT.

Q: Posso definire una lista fissa di beneficiari?
A: Sì, passa un array con i dati completi dei beneficiari autorizzati.

Q: Cosa significa ID beneficiario = 0?
A: Indica che il dipendente ha inserito i dati di un beneficiario "a piacere" (scenario 1).

Q: I beneficiari ereditano l'email del dipendente?
A: Solo se non specificata. È consigliabile fornire sempre un'email specifica per ogni beneficiario.

Domande JWT

Q: Quanto può durare un token JWT?
A: Massimo 4 ore. Il tempo consigliato è 1-2 ore per ragioni di sicurezza.

Q: Cosa succede se l'orologio del server non è sincronizzato?
A: La tolleranza è di 5 minuti. Oltre questo limite il token viene rifiutato.

Q: Posso riutilizzare lo stesso JWT per più utenti?
A: No, ogni token deve essere specifico per un dipendente e una sessione.

Domande Errori Comuni

Q: Ricevo "invalid jwt signature", cosa faccio?
A: Verifica che la chiave segreta sia corretta e l'algoritmo sia HS256.

Q: Il callback fallisce con timeout, perché?
A: Ottimizza le query database e implementa caching. Il limite è 25 secondi.

Q: Ricevo "domain validation error"?
A: Gli endpoint callback devono essere sullo stesso dominio del JWT issuer, oppure usa skipDomainCheck: true.

Q: Errore 402 "insufficient credit"?
A: Il dipendente/beneficiario non ha credito sufficiente. Verifica il saldo disponibile.