> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fotostudio.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Integrazione SumUp

# 💳 Connessione SumUp a Fotostudio

## Cos'è SumUp?

[SumUp](https://www.sumup.com/) è una soluzione di pagamento con carta bancaria destinata a liberi professionisti e piccole imprese. La connessione con Fotostudio permette ai tuoi clienti di pagare le fatture online tramite SumUp, nello stesso modo in cui puoi proporre il pagamento tramite Stripe o altri metodi di pagamento.

---

## Cosa fa l'integrazione

Una volta attivata, l'integrazione permette di:

| Funzionalità | Dettaglio |
| ---- | ---- |
| **Pagamento online** | I tuoi clienti possono pagare le fatture online con carta bancaria tramite SumUp |
| **Link di pagamento** | Un link di pagamento SumUp viene generato automaticamente sulle fatture interessate |
| **Conferma automatica** | La fattura viene contrassegnata come pagata in Fotostudio appena ricevuto il pagamento |

---

## Come connettere SumUp

### Passo 1: Creare una chiave API in SumUp

> ⚠️ La chiave API viene visualizzata **una sola volta** al momento della sua creazione. Copiala immediatamente e conservala in un luogo sicuro (gestore di password, ecc.).

1. Accedi al tuo account su [me.sumup.com](https://me.sumup.com/)
2. Clicca sul tuo profilo in alto a destra per espanderlo, poi apri **Impostazioni > Impostazioni aziendali**
3. Vai in **Per sviluppatori** → **Toolkit**
4. Seleziona **Chiavi API** (la pagina mostra la chiave pubblica SumUp — non usarla per la tua integrazione)
5. Clicca su **Crea** e dai un nome alla chiave per riconoscerla più tardi (per esempio: `Fotostudio`)
6. Una volta generata la chiave, **copiala o scaricala immediatamente** — SumUp non la memorizza e non potrà ridartela

### Passo 2: Configurare SumUp in Fotostudio

1. In Fotostudio, vai in **Moduli** > **Pagamenti online**
2. Clicca sul pulsante **Configura** di fronte a **SumUp**
3. Incolla la tua chiave API nel campo previsto
4. Clicca su **Testa la connessione** per verificare che la chiave sia valida
5. Attiva il pagamento e clicca su **Salva**

---

## Buone pratiche di sicurezza

* **Non condividere mai** la tua chiave API in un'email, una chat o un repository di codice
* **Ruota** la chiave regolarmente: creane una nuova in SumUp, aggiornala in Fotostudio, poi revoca quella vecchia
* **Revoca immediatamente** qualsiasi chiave di cui sospetti una compromissione dall'interfaccia SumUp (**Impostazioni** → **Per sviluppatori** → **Toolkit** → **Chiavi API**)
* In caso di dubbio, contatta il supporto Fotostudio

---

## Domande frequenti

**Non trovo l'opzione "Per sviluppatori" in SumUp.**
Questa sezione è disponibile solo per account commercianti attivi. Assicurati di essere connesso con un account che ha accesso al back-office SumUp (e non un account dipendente senza diritti di amministrazione). Puoi anche andare sul [portale sviluppatori di SumUp](https://developer.sumup.com/).

**Posso usare la chiave pubblica SumUp?**
No. La chiave pubblica visibile sulla pagina è riservata ad altri usi. Crea imperativamente una chiave dedicata tramite il pulsante **Crea**.

**Ho perso la mia chiave API.**
SumUp non memorizza le chiavi generate: è impossibile recuperarla. Vai in **Impostazioni** → **Per sviluppatori** → **Toolkit** → **Chiavi API**, revoca la vecchia chiave e creane una nuova, poi aggiornala in Fotostudio.

**La connessione fallisce dopo aver inserito la mia chiave.**
Verifica di aver copiato la chiave per intero, senza spazi né caratteri mancanti. Se il problema persiste, revoca la chiave e creane una nuova.