CryptoPayIn
Centro assistenza · 50 risposte

Come possiamo aiutarti?

Risposte dirette su account, pagamenti, la commissione dell'1%, payout, integrazione e sicurezza. Scegli un argomento — e se la tua domanda non è qui, una persona reale risponde a ogni ticket dalla tua dashboard.

Account e chiavi

Come si crea un account?

Fai clic su Crea account in un punto qualsiasi del sito. Il server genera una chiave account a 16 cifre, la mostra una sola volta, e sei dentro — nessuna email, password o documento. Consulta la pagina No-KYC per capire perché funziona così.

Cosa succede se perdo la mia chiave account?

Senza i codici di recupero 2FA, una chiave persa non è recuperabile per progettazione — non la conserviamo mai in una forma recuperabile e non disponiamo di un'email con cui reimpostarla. Conservala come faresti con il contante. Attivare la 2FA TOTP ti offre anche dieci codici di recupero monouso; conserva anche quelli in un luogo sicuro.

Posso aggiungere un secondo livello di sicurezza?

Sì — attiva l'autenticazione a due fattori TOTP in Impostazioni → Sicurezza. Funziona con qualsiasi app di autenticazione e ricevi dieci codici di recupero monouso. Con la 2FA attiva, anche i prelievi richiedono un codice aggiornato.

È vero che non c'è alcun KYC, a qualsiasi volume?

Nessuno, a qualsiasi volume, mai. Non esiste alcun livello di compliance, nessuna richiesta di documenti né alcuna coda di revisione in nessuna parte del prodotto — l'identità semplicemente non viene mai raccolta.

Come chiudo il mio account?

Da Impostazioni, una volta che il saldo è inferiore a $1 (prima preleva il resto). La chiusura rimuove la configurazione dell'account; la registrazione nel registro append-only viene conservata per l'integrità della piattaforma.

Accettare pagamenti

Come funziona realmente un pagamento?

Crei una fattura — tramite l'API, un link di pagamento senza codice, oppure un negozio. Il cliente atterra su un checkout ospitato con un codice QR e un indirizzo dedicato, paga da qualsiasi wallet, e noi monitoriamo la blockchain e ti accreditiamo l'importo nel momento in cui si conferma.

Come faccio a sapere se un pagamento è stato effettivamente pagato?

Fidati del webhook firmato o di una lettura API autenticata — mai del reindirizzamento del browser. L'URL di reindirizzamento è una comodità per il cliente; può essere abbandonato, ripetuto o contraffatto, quindi non costituisce prova di pagamento. Consulta i webhook nella documentazione.

Come viene stabilito il tasso di cambio?

Due snapshot — fiat→USD e crypto→USD — si bloccano insieme nell'istante in cui viene creata una fattura, reperiti e verificati incrociando fonti indipendenti. I tassi obsoleti o anomali falliscono in modalità sicura: la fattura si rifiuta di essere creata piuttosto che quotare male la tua vendita.

Cosa succede se un cliente paga meno del dovuto?

La fattura resta aperta e mostra l'esatto importo residuo al checkout e nella tua dashboard — un piccolo sollecito di solito la completa. I pagamenti parziali non vengono mai registrati silenziosamente come pagati.

Cosa succede se un cliente paga più del dovuto?

L'intero importo ricevuto viene accreditato e la fattura si salda come pagata. Puoi trattenere l'eccedenza, oppure restituirla come payout all'indirizzo del cliente, se preferisci.

Quando scade una fattura?

Dopo 30 minuti per impostazione predefinita — puoi impostare qualsiasi valore fino a 24 ore. Una fattura scaduta non può essere pagata; basta crearne una nuova. I fondi già arrivati on-chain vengono comunque accreditati.

Posso fare test prima di andare in produzione?

Non esiste un ambiente sandbox — l'API è solo live. Testa l'intero flusso con un piccolo importo reale su una blockchain veloce ed economica come Solana o Tron, che si liquidano in pochi secondi per frazioni di centesimo.

Valute e reti

Con quali criptovalute possono pagare i miei clienti?

Dodici asset su sette reti — Bitcoin, Ethereum, Monero, Solana, Litecoin, Dogecoin, Tron, USDT (TRC-20 & ERC-20), USDC, DAI, SHIB e PEPE. La pagina delle valute elenca conferme e tempi di liquidazione in tempo reale.

Quando un pagamento è definitivo?

Quando raggiunge la soglia di conferma della propria rete — da pochi secondi (Solana, Tron) a circa 20 minuti (Bitcoin, Monero, Dogecoin). Una volta confermato, il regolamento è definitivo: le criptovalute non prevedono storni (chargeback).

Supportate davvero Monero?

Sì, di prima classe, sulla nostra infrastruttura di nodi proprietaria. Ogni fattura riceve un subaddress univoco, così gli ID di pagamento vengono gestiti automaticamente — nulla che il tuo cliente debba incollare o rischiare di perdere. Consulta la pagina su Monero.

Esiste un importo minimo di pagamento?

Un piccolo minimo per ciascun asset — in genere tra $0.50 e pochi dollari, mostrato al checkout e tramite l'API — evita che i micropagamenti vengano erosi dalle commissioni di rete.

Commissioni

Quanto costa CryptoPayIn?

1% fisso per ogni pagamento liquidato. Nient'altro — nessuna commissione di attivazione, mensile, per fattura, di conversione o di storno. La pagina delle commissioni confronta onestamente questo costo con BitPay, CoinGate e NOWPayments.

Chi paga la commissione di rete della blockchain?

Il tuo cliente paga la commissione di rete sul proprio deposito, come in qualsiasi trasferimento da wallet. Al prelievo, paghi solo la commissione di rete della transazione di payout — mostrata in tempo reale prima della conferma, senza alcun margine aggiunto da parte nostra.

Ci sono sconti sui volumi o tariffe negoziate?

No, deliberatamente. Ogni esercente paga lo stesso 1% fisso dalla prima fattura fino a sette cifre al mese — nessun listino tariffario, nessuna chiamata commerciale, nessun livello opaco.

C'è una commissione di conversione valutaria o FX?

No. I prezzi in 30 valute fiat e la contabilità in USD sono inclusi, e il tasso verificato in modo indipendente che si blocca alla creazione della fattura è il tasso a cui liquidi — non viene aggiunto alcuno spread.

Payout e rimborsi

Come funzionano i prelievi?

Istantaneamente dalla tua dashboard, oppure automaticamente. I fondi vengono riservati nel momento in cui li richiedi e inviati on-chain — di solito entro pochi minuti. Non esiste alcuna coda di approvazione né alcun modo per chiunque di congelarli.

Cos'è il prelievo automatico?

Imposta un indirizzo di destinazione e una soglia di saldo per ciascun asset; quando il saldo di una moneta supera la soglia, questa viene trasferita automaticamente al tuo wallet. È disattivato per impostazione predefinita e lo attivi tu, per account.

C'è un limite sui payout automatici?

I trasferimenti automatici sono limitati a $1,000 per payout come misura di sicurezza; qualsiasi importo superiore viene messo in coda perché tu lo rilasci manualmente. I prelievi manuali non hanno questo limite.

In quale asset ricevo il mio denaro?

Nell'asset con cui ha pagato il tuo cliente. I saldi sono mostrati in termini di USD per chiarezza, ma vengono prelevati nello stesso asset verso indirizzi che controlli tu.

Un prelievo richiede la 2FA?

Se hai attivato la 2FA TOTP, sì — ogni prelievo, dalla dashboard o dall'API, richiede un codice aggiornato. È l'unica azione per cui viene sempre richiesto un codice, perché sposta denaro.

Come funzionano i rimborsi?

Un rimborso è semplicemente un prelievo che invii all'indirizzo del cliente — non c'è alcuna procedura di contestazione da affrontare, perché le criptovalute non prevedono storni. I rimborsi in stablecoin sono esatti; per gli asset volatili, specifica nei tuoi termini se rimborsi l'importo in crypto o il controvalore in fiat.

Cosa succede se invio un payout all'indirizzo sbagliato?

Le transazioni on-chain sono irreversibili — i fondi inviati a un indirizzo errato o digitato male vengono persi. Verifica sempre con attenzione; il modulo di prelievo ti avvisa prima della conferma.

Negozi online

Cos'è un negozio?

Una vetrina ospitata che raggruppa più prodotti in un'unica pagina personalizzata — senza codice, due temi, anteprima dal vivo. Ogni prodotto è, sotto il cofano, un link di pagamento, quindi consegna e chiavi funzionano allo stesso modo.

I negozi hanno un proprio dominio?

Sì — le vetrine risiedono sul dominio dedicato shopycrypto.com (separato dai tuoi link di checkout), così i clienti vedono un URL pulito e specifico per il negozio.

Quanti negozi e prodotti posso avere?

Fino a 10 negozi per account, 50 prodotti per negozio, e fino a 30 combinazioni di varianti per prodotto (taglie, edizioni, livelli…), ciascuna con il proprio prezzo e il proprio inventario di chiavi.

Posso vendere prodotti fisici, non solo digitali?

Sì. Contrassegna un prodotto come fisico e scegli i paesi verso cui spedisci; il checkout raccoglierà quindi un indirizzo di spedizione. Gli articoli digitali e fisici vengono acquistati in checkout separati.

Sviluppatori e API

Quanto tempo richiede l'integrazione?

Un link di pagamento non richiede alcun codice. L'API REST è essenzialmente un unico endpoint per creare un pagamento (POST /v1/payments) più un webhook per ricevere la conferma del regolamento — la maggior parte degli sviluppatori va in produzione in un pomeriggio grazie a la documentazione.

Come funzionano l'autenticazione e gli scope dell'API?

Chiavi segrete di tipo bearer, fino a 50 per account. Ogni chiave porta con sé un insieme fisso di scope scelti alla creazione — payments, links, shops, balance e payouts (lettura/scrittura). Gli scope non possono essere ampliati in seguito; emetti invece una nuova chiave. Una chiamata al di fuori dei permessi concessi a una chiave restituisce 403 insufficient_scope.

Come evito addebiti doppi sui retry?

Invia un header Idempotency-Key (1–128 caratteri) quando crei un pagamento. Ripetere la stessa chiave restituisce il pagamento originale; riutilizzarla con un corpo diverso restituisce 409 idempotency_conflict.

Ci sono limiti di frequenza?

Sì, per chiave e per IP. Ogni risposta include X-RateLimit-Limit, -Remaining e -Reset; il superamento del limite restituisce 429 con un Retry-After, e l'edge applica una propria protezione per IP.

Che aspetto hanno gli errori dell'API?

Una busta JSON coerente: {"error":{"type","message","request_id"}}. I tipi includono invalid_request, invalid_parameter, insufficient_scope, rate_limited, idempotency_conflict e temporarily_unavailable. Cita il request_id in qualsiasi ticket di assistenza.

Cosa posso gestire tramite l'API?

Pagamenti, link di pagamento, negozi con i relativi prodotti e varianti, i tuoi saldi e i prelievi (con 2FA). GET /v1/account restituisce gli scope della chiave chiamante e i limiti del tuo account.

Webhook e sicurezza

Come vengono protetti i webhook?

Ogni evento è firmato con HMAC-SHA256 e dotato di timestamp; verifica la firma rispetto al secret del tuo endpoint prima di considerarlo attendibile. Le consegne fallite vengono ritentate automaticamente con backoff. Gli snippet di verifica si trovano in la documentazione.

Quali eventi webhook vengono generati?

L'intero ciclo di vita del pagamento: payment.created, pending, confirming, completed, underpaid, overpaid, expired e failed — più webhook.test. Rendi il tuo handler idempotente; i nuovi tentativi vanno previsti.

Posso avere più di un endpoint webhook?

Sì — fino a 10 endpoint, validi per l'intero account oppure legati a una chiave API specifica, ciascuno con un proprio secret che puoi ruotare. Ogni evento viene distribuito a tutti gli endpoint corrispondenti, e puoi reinviare qualsiasi consegna dalla dashboard.

Come viene protetto il mio saldo?

Un registro append-only a partita doppia annota ogni movimento in modo immutabile — i saldi sono spiegabili riga per riga e nulla viene mai cancellato. La 2FA TOTP protegge l'accesso e i prelievi, mentre header di sicurezza rigorosi, limiti di frequenza e un percorso di rete isolato e solo in uscita proteggono la piattaforma.

CryptoPayIn è custodial?

I saldi si accumulano sulla piattaforma tra la liquidazione e il prelievo, come in qualsiasi gateway ospitato. Le soglie di prelievo automatico ti permettono di mantenere questo flottante il più vicino allo zero che desideri — la destinazione è sempre un wallet che controlli tu.

Assistenza e norme

Perché fidarsi di un gateway che non sa chi sono?

Per lo stesso motivo per cui ti fidi di un distributore automatico: il meccanismo, non la burocrazia. I tassi si verificano in modo indipendente e falliscono in modalità sicura, il registro non cancella mai nulla, i webhook sono firmati e la commissione è un unico numero trasparente. L'identità non ha mai fatto parte di questa catena di fiducia.

Cosa non mi è permesso vendere?

Tutto ciò che è illecito secondo la legge applicabile a te o ai tuoi clienti — consulta i termini. L'assenza di KYC elimina la burocrazia su di te, non la legge sul tuo prodotto; resti responsabile di ciò che vendi.

Sono responsabile delle tasse?

Sì. I ricavi in crypto sono ricavi ordinari in praticamente ogni giurisdizione. Il tuo registro denominato in USD e le esportazioni CSV (Analytics → Export) rendono semplice la contabilità.

Come ricevo assistenza?

Apri un ticket dalla tua dashboard (Supporto nella barra laterale); i ticket ricevono risposta da persone reali, senza livelli di account manager. Includi un request_id per qualsiasi richiesta relativa all'API.

Domande risolte? Bene. Crea una fattura.

Il tuo account è a un clic di distanza — nessun KYC, nessuna attesa. Una commissione fissa dell’1% a transazione. Nessun abbonamento, nessun costo di attivazione.