Come collego il mio sito o bot tramite l'API?
Il team ScarabPay · Aggiornato il 19 ottobre 2026
Usa l’API se vuoi che gli ordini vengano pagati e consegnati automaticamente. Il tuo server crea una fattura, invia il cliente alla pagina di pagamento e riceve un webhook firmato quando arriva il pagamento.
1. Ottieni le chiavi
Apri il progetto e la scheda Developers. Ricevi una chiave live per i pagamenti reali e una chiave sandbox per le prove.
Tieni segreta la chiaveLa chiave viene mostrata una sola volta. Conservala solo sul tuo server, mai in un’app o in una pagina pubblica. Se viene esposta, tocca Replace key.
2. Aggiungi il webhook
- Inserisci l’URL del tuo sito o del server del bot che riceverà gli eventi e tocca Save.
- Copia il segreto di firma e conservalo sul tuo server.
- Tocca Send test event e verifica che il server risponda con lo stato 200.
3. Crea le fatture
Invia una richiesta per creare una fattura con l’importo e il numero d’ordine, poi reindirizza il cliente al link di pagamento ricevuto. Quando arriva l’evento invoice.paid, consegna l’ordine.
Indirizzi fissi
Per le ricariche di saldo nei bot puoi assegnare a ogni cliente un indirizzo di deposito permanente. Ogni deposito invia l’evento deposit.received.
Esempi completi in PHP, Node.js e Python sono nella documentazione dell’API.