Documentazione
Connetti CryptoGain alla tua app
Accetta Bitcoin e USDT sul tuo sito con una sola chiamata API. Genera le tue credenziali, collegale e inizia a incassare.
1
Genera le credenziali
Nella tua dashboard vai in Sviluppatori → Genera credenziale. Ottieni un Key ID pubblico e un API Secret mostrato una sola volta. Conserva il secret in modo sicuro (variabili d'ambiente del tuo server): noi ne salviamo solo l'hash.
2
Aggiungi «Connetti CryptoGain»
Nella tua app metti un pulsante e un campo dove l'utente incolla l'API Secret. Valida la connessione chiamando il nostro endpoint di verifica:
curl https://cryptogain-e57be.web.app/api/v1/ping \
-H "Authorization: Bearer <API_SECRET>"
# → { "connected": true, "merchant": { "businessName": "..." },
# "chains": ["BTC","USDT_TRC20"], "feePercent": 1.5 }3
Crea un pagamento
Dal tuo server, per ogni ordine crea un invoice e rimanda il cliente al
checkoutUrl:curl -X POST https://cryptogain-e57be.web.app/api/v1/invoices \
-H "Authorization: Bearer <API_SECRET>" \
-H "Content-Type: application/json" \
-d '{ "amount": 29.90, "currency": "eur", "chain": "BTC", "orderId": "ORD-123" }'
# → { "id": "inv_...", "address": "...", "checkoutUrl": "https://cryptogain-e57be.web.app/pay/inv_...",
# "amount": { "crypto": "0.00042", ... }, "expiresAt": ... }4
Ricevi la conferma (webhook)
Imposta un Webhook URL in Impostazioni. A ogni cambio stato ti inviamo una notifica firmata (HMAC-SHA256), con retry automatico. Verifica la firma così:
// header: X-CryptoGain-Signature: sha256=<hex>
// X-CryptoGain-Timestamp: <ms>
const expected = crypto
.createHmac('sha256', WEBHOOK_SECRET)
.update(timestamp + '.' + rawBody)
.digest('hex');
if (expected === signature) { /* pagamento confermato */ }🔌 Prova la tua credenziale
Incolla l'API Secret generato in dashboard: verifichiamo la connessione (come farebbe il bottone “Connetti CryptoGain” nella tua app).