Abilita Logging Verbose
Logga tutti i payload webhook in entrata e le risposte del tuo handler
Risoluzione Problemi
Risoluzione Problemi
Hai problemi con la tua integrazione? Trova soluzioni ai problemi comuni qui sotto, o contatta il supporto per assistenza personalizzata.
Problemi Comuni
Webhook non ricevuto
Possible Causes
- URL webhook non configurato nella dashboard
- Firewall blocca richieste in entrata
- Problemi certificato SSL
- Endpoint restituisce stato non-2xx
Solutions
- Verifica che l'URL sia configurato nelle impostazioni SanPay
- Controlla che il firewall del server permetta richieste POST esterne
- Assicurati di avere un certificato SSL valido (no self-signed in produzione)
- Rispondi 200 OK immediatamente, elabora in modo asincrono
Verifica firma fallita
Possible Causes
- Segreto webhook sbagliato
- Body richiesta modificato da middleware
- Sfasamento orario tra server
Solutions
- Copia il segreto webhook esattamente dalla dashboard
- Verifica il body raw prima di qualsiasi parsing JSON
- Permetti ±5 minuti di tolleranza sul timestamp
Modal SDK non si apre
Possible Causes
- Origine non in whitelist
- ID sessione invalido
- Errore JavaScript sulla pagina
Solutions
- Aggiungi il tuo dominio (con protocollo) alle origini consentite
- Verifica che la sessione sia stata creata con successo
- Controlla la console browser per errori
Pagamento bloccato su PENDING_SELECTION
Possible Causes
- Il cliente non ha ancora selezionato una valuta
- Sessione scaduta
Solutions
- Questo è normale—il cliente sceglie la crypto nel modal
- Controlla il timestamp expiresAt
Ordine non si aggiorna dopo pagamento
Possible Causes
- Errore handler webhook
- Transazione database fallita
- Evento elaborato ma duplicato ignorato
Solutions
- Controlla i log dell'handler webhook per errori
- Verifica la logica di matching ID ordine
- Controlla l'implementazione della deduplicazione eventId
Suggerimenti Debug
Controlla la Dashboard
Visualizza i log di consegna webhook nel pannello admin SanPay
Usa Modalità Test
Debug con pagamenti testnet prima di andare live
Verifica Chiavi API
Assicurati di usare coppie di chiavi matching (test con test, live con live)
Riferimento Codici Errore
| Codice | HTTP Status | Causa | Soluzione |
|---|---|---|---|
UNAUTHORIZED | 401 | Chiave API invalida o mancante | Controlla che la chiave API sia corretta e attiva |
FORBIDDEN | 403 | Origine non consentita | Aggiungi il tuo dominio alle origini consentite |
SESSION_EXPIRED | 400 | Sessione checkout scaduta | Crea una nuova sessione checkout |
INVALID_AMOUNT | 400 | Formato importo invalido | Usa stringa numerica: "99.99" |
UNSUPPORTED_CURRENCY | 400 | Valuta non abilitata | Controlla le valute supportate nella dashboard |
RATE_LIMITED | 429 | Troppe richieste | Implementa backoff esponenziale |
Hai Bisogno di Altro Aiuto?
Se non trovi una soluzione qui:
Documentazione
Consulta il riferimento API completo
Supporto Email
[email protected] per problemi tecnici
Log Dashboard
Visualizza log dettagliati richieste e webhook