LogoLogo
V2.0.3
V2.0.3
  • 🏠Carta Giovani Nazionale - Documentazione Tecnica
  • 🕐Storico delle modifiche
  • 📑Premessa
  • 🤝aderire al programma
    • Come si diventa Partner
    • I requisiti
  • ✍️il convenzionamento
    • Il convenzionamento
      • Dettaglio dati: Operatore
    • Firma della convenzione
    • Esito della richiesta di convenzionamento
  • 🪄Le opportunità
    • Cos'è un'opportunità
    • Come creare un'opportunità
      • Dettaglio dati: opportunità
    • Le modalità di riconoscimento e validazione delle opportunità
      • 1️⃣Presenza fisica del Beneficiario
      • 2️⃣Modalità API
      • 3️⃣Modalità codice sconto statico
      • 4️⃣Modalità lista di codici statici
      • 5️⃣Modalità landing page
    • Stati delle opportunità
    • Riconoscimento delle opportunità ai titolari di EYCA
  • 🖍️Manuale di scrittura per gli operatori
    • Guida alla scrittura
    • La scheda dell'Operatore
    • La scheda dell'opportunità
  • 🔄RICHIESTE DI MODIFICA
    • Come modificare la scheda operatore e delle opportunità
    • Come aggiungere, sostituire e/o cancellare un Referente
  • 🔵l'app IO
    • La Carta Giovani Nazionale nell'App IO
    • Lista delle opportunità visibile su App IO
  • ⬇️appendice
    • Assistenza
    • Glossario
    • Branding
    • Ulteriori termini e condizioni d'uso del Portale
Powered by GitBook
On this page
  • Esperienza utente
  • Formato OTP

Was this helpful?

  1. Le opportunità
  2. Le modalità di riconoscimento e validazione delle opportunità

Modalità API

PreviousPresenza fisica del BeneficiarioNextModalità codice sconto statico

Was this helpful?

Nel caso in cui l’Operatore abbia scelto di aderire al Programma attraverso il proprio sito web e/o e-commerce e tramite il Modello API, l’identificazione del Beneficiario quale avente diritto all’opportunità coincide con l’applicazione o il riconoscimento dell’opportunità medesima in fase di acquisto, attraverso i seguenti passaggi:

  • Il Beneficiario seleziona il bene/servizio, oggetto dell'opportunità, sull’e-commerce dell’Operatore e arriva alla pagina di “checkout”;

  • Al momento dell’acquisto, il Beneficiario accede alla sua CGN sull’App IO, apre la schermata relativa all’opportunità e genera un codice sconto temporaneo (OTP) per quella opportunità, della durata di 10 minuti o fino a completamento della transazione, se più breve;

  • Il Beneficiario inserisce il codice generato nell’apposito campo predisposto dall’Operatore sul proprio e-commerce per l’applicazione di sconti e opportunità;

  • I sistemi dell’Operatore interrogano le API messe a disposizione da PagoPA S.p.A. per verificare la validità del codice.

In caso di risposta positiva (codice 200), l’opportunità viene applicata alla transazione e il corrispondente OTP utilizzato viene invalidato per impedirne un ulteriore uso. In caso di risposta negativa (codice 404), l’Operatore visualizza il relativo messaggio di errore e l’opportunità non verrà applicata.

Gli errori collegati al fallimento della fase di validazione consistono nei seguenti stati:

  • codice OTP scaduto (in caso di mancato utilizzo entro i 10 minuti di validità);

  • codice OTP invalido (codice 400);

  • codice OTP inesistente.

I sistemi dell’App IO che si occupano della validazione, controllano automaticamente, inoltre, che non esista già un codice OTP in corso di validità per il Beneficiario richiedente per la specifica opportunità. Nel caso in cui esista un OTP ancora valido per quella opportunità (perché non utilizzato o non scaduto), viene restituito all’Operatore il codice di errore 409, che indica il conflitto con un OTP ancora valido.

Gli Operatori che intendono aderire utilizzando il Modello API, devono attenersi strettamente a quanto descritto nella presente documentazione tecnica reperibile al presente , da ritenersi come parte integrante e sostanziale della Convenzione in virtù del presente riferimento.

Una volta approvata la richiesta di Convenzione da parte del Dipartimento, gli Operatori che hanno scelto il Modello API, potranno trovare le proprie API key all’interno della sezione “Profilo” nel Portale. Per qualsiasi necessità, nella medesima sezione gli Operatori possono generare nuove API key.

Non appena le API key vengono rigenerate, quelle precedenti non saranno più utilizzabili.

Esperienza utente

Esempio di carrello di un Operatore con il campo di testo per l’inserimento del codice sconto

Il codice OTP può essere direttamente incollato nel campo dell’e-commerce. Se risulta valido, lo sconto verrà applicato al carrello

Formato OTP

I codici OTP generati dall’App IO per CGN sono formati da 11 caratteri alfanumerici e utilizzano l’alfabeto maiuscolo inglese. Un OTP identifica univocamente un tentativo di acquisto online e pertanto può essere utilizzato una sola volta.

🪄
2️⃣
link
Dal dettaglio dell'opportunità, l'utente genera un codice OTP