Chiavi Api (Api Keys) - Sezione Applicazioni

1. Cos'è la sezione "Applicazioni"?

Dal menu laterale → Applicazioni.

La pagina ha sottotitolo "Gestisci le chiavi API delle tue applicazioni e dei punti vendita." ed è composta da due sezioni:

• Applicazioni — l'elenco delle applicazioni associate al tuo account ZPay.
• Punti vendita — l'elenco dei punti vendita / sales channels (visibile solo se ne hai almeno uno configurato).

Per ogni voce sono mostrate due chiavi: Merchant Key (chiave privata) e Merchant Public Key (chiave pubblica), che servono alle tue integrazioni per comunicare con ZPay.

Le chiavi vengono generate da ZPay: dalla pagina puoi consultarle, autorizzare l'applicazione, gestirne i conti collegati e inviare le credenziali via email.

2. Sezione "Applicazioni"

La tabella mostra le seguenti colonne:

• Nome — nome dell'applicazione
• Merchant Key — chiave privata dell'applicazione. Se non è ancora disponibile compare il badge "Configurazione in corso".
• Merchant Public Key — chiave pubblica dell'applicazione
• Limite conti — numero massimo di conti associabili all'applicazione (oppure — se non definito, per le chiavi utilizzare per il servizio AIS)
• Azioni — pulsante contestuale:
  • "Autorizza" quando la Merchant Key non è ancora stata generata: avvia il processo di autorizzazione dell'applicazione e mostra la notifica "Applicazione autorizzata!" in caso di successo.
  • "Gestisci conti" quando l'applicazione è già autorizzata: apre la modale per associare i conti bancari all'applicazione.

3. Sezione "Punti vendita"

La tabella compare solo se hai almeno un punto vendita configurato e mostra:

• Nome
• Merchant Key (con badge "Configurazione in corso" se non ancora disponibile)
• Merchant Public Key
• Azioni:
  • Icona busta (Invia chiave via email) — disponibile quando la Merchant Key è già stata generata. Apre la modale "Invia credenziali API".
  • Icona espandi (Mostra QR code) — disponibile solo per i punti vendita di tipo SoftPOS che hanno terminal ID configurati. Apre una modale con un QR code per ogni terminal ID.

4. Come invio le credenziali API via email?

Dalla riga del punto vendita, clicca l'icona busta nella colonna Azioni. Si apre la modale "Invia credenziali API" in cui scegli il metodo di invio tramite due card:

• Gestionale — seleziona dal menu a tendina un contatto/gestionale già configurato sull'account. L'email viene compilata automaticamente.
• Email manuale — inserisci manualmente l'indirizzo email del destinatario.

Clicca "Invia" per spedire le credenziali. In caso di successo compare la notifica "Email inviata con successo."; con "Annulla" chiudi la modale senza inviare.

5. Come gestisco i conti collegati a un'applicazione?

Dalla riga dell'applicazione (sezione Applicazioni) clicca "Gestisci conti". Si apre la modale che ti permette di selezionare quali conti bancari associare a quell'applicazione, fino al limite indicato nella colonna Limite conti.

6. Come visualizzo il QR code di un punto vendita SoftPOS?

Dalla riga del punto vendita SoftPOS clicca l'icona espandi nella colonna Azioni. Si apre la modale "QR Code" che mostra un QR per ogni Terminal ID configurato, con relativa etichetta Terminal ID: …. Chiudi la modale con il pulsante "Chiudi".

7. Posso modificare le chiavi (Merchant Key / Merchant Public Key)?

No. Le chiavi sono generate e gestite da ZPay: dalla pagina Applicazioni puoi solo consultarle e inviarle via email. Per ogni esigenza di rigenerazione o modifica, contatta assistenza@zpay.it.