Testing e Sandbox

Usa il nostro ambiente sandbox per testare la tua integrazione prima di andare live. Testa con transazioni blockchain reali su testnet—nessuna criptovaluta reale richiesta.

Modalità Testnet

La modalità sandbox è abilitata automaticamente quando si usano chiavi API test:

Prefisso Chiave	Ambiente	Rete
`pk_test_, sk_test_`	Sandbox	Bitcoin Testnet, Ethereum Sepolia
`pk_live_, sk_live_`	Produzione	Bitcoin Mainnet, Ethereum Mainnet

Ottenere Coin di Test

Avrai bisogno di coin testnet per simulare i pagamenti:

Bitcoin Testnet

Cerca 'Bitcoin testnet faucet' per tBTC gratuiti

Sepolia ETH

Usa Alchemy, Infura o altri faucet Sepolia

Stablecoin Testnet

Contatta il supporto per USDT/USDC testnet

Simulare Pagamenti

Crea Checkout Test
Usa la tua chiave pubblica test per creare una sessione checkout
Apri Checkout
Completa il flusso checkout come farebbe un cliente
Invia Pagamento Test
Usa un wallet testnet per inviare l'importo esatto
Verifica Webhook
Conferma che il tuo handler webhook riceva gli eventi test

Testing Webhook

Per sviluppo locale, esponi il tuo endpoint webhook:

Usa ngrok o simile per creare un URL pubblico
Configura l'URL pubblico nelle impostazioni SanPay
Monitora le richieste in arrivo nei log locali

Checklist Pre-Produzione

✅ Crea pagamento e ricevi webhook PAYMENT_CONFIRMED
✅ Gestisci PAYMENT_EXPIRED correttamente
✅ Verifica che la validazione firma webhook funzioni
✅ Testa scenari di sottopagamento e sovrapagamento
✅ Conferma che lo stato ordine si aggiorni correttamente
✅ Testa gestione errori e messaggi utente