UnifiWallet Payments

L’acquirente paga. Tu sei pagato. Stessa transazione.

Nessun tempo di accredito, nessun prelievo da richiedere, nessun saldo che qualcuno possa congelare. Il denaro lascia il suo wallet e arriva nel tuo.

Che cos’è questo servizio

UnifiWallet Payments è un gateway di pagamento in criptovaluta. Il tuo negozio ci chiede di creare un pagamento, noi mostriamo all’acquirente la pagina di pagamento, e il suo denaro va direttamente nel wallet del negozio. Poi avvisiamo il negozio che è arrivato.

È qui la differenza rispetto a un gateway tradizionale: non esiste un saldo presso di noi, non esiste un calendario di accredito e non c’è nulla che possiamo bloccare. La nostra commissione viene trattenuta all’interno della stessa transazione che ti paga.

Cosa è bene sapere

  • Il tuo denaro non è presso di noi. La transazione dell’acquirente paga direttamente l’indirizzo del tuo wallet.
  • Le commissioni di rete le anticipiamo noi e vengono detratte dall’importo: non devi tenere criptovaluta nativa.
  • Il venditore sei tu, non noi. Il contratto di vendita è tra te e il tuo cliente.
  • I rimborsi li invii tu. Registriamo quanto è dovuto, costruiamo la transazione e la verifichiamo sulla catena.
  • Un ordine può essere trattenuto: il denaro resta in uno smart contract e lo incassi alla spedizione.

Ciò che nessuno può annullare

Una transazione confermata su una blockchain non è reversibile. Se il denaro finisce a un indirizzo sbagliato, se perdi la chiave del tuo wallet, o se l’emittente di un token congela il tuo indirizzo, non possiamo farci nulla: quel denaro non è mai stato nelle nostre mani.

La stessa proprietà che ci impedisce di congelare i tuoi fondi ci impedisce anche di recuperarli. È il compromesso alla base di questa architettura.

Domande frequenti

Quando ricevo il denaro?

Non appena l’acquirente paga. Non c’è alcun ritardo perché non esiste una fase di accredito: la transazione che l’acquirente firma è il pagamento a te. Prima di spedire, però, aspetta lo stato completed, non settled.

Quanto costa?

Una percentuale su ogni pagamento, trattenuta nella stessa transazione, più le commissioni di rete. Nessun canone mensile, nessuna commissione di accredito, nessuna penale per i rimborsi.

Chi paga le commissioni di rete?

Lo decidi tu. Per impostazione predefinita si aggiungono al totale dell’acquirente e gli vengono mostrate come voce separata; puoi anche assumertele, e allora vengono detratte dal tuo incasso.

L’acquirente ha bisogno di ETH?

No. L’acquirente si limita a firmare; la transazione la inviamo noi. Chi possiede soltanto USDC può pagare, ed è la situazione più comune.

Cosa succede se perdo l’accesso al mio wallet?

Il denaro è perso e non possiamo aiutarti. Non è mai stato nostro. Scegli un wallet a cui avrai accesso anche fra cinque anni.

Perché un nuovo indirizzo di accredito non è attivo subito?

Per uno scenario preciso: qualcuno ottiene le tue credenziali e cambia l’indirizzo di accredito nel cuore della notte. Il periodo di attesa, l’email a tutti i titolari e la firma richiesta dal wallet sono tre ostacoli distinti su quella strada.

Come funzionano i rimborsi?

Li invii tu. Registriamo quanto è dovuto con una scadenza, costruiamo la transazione esatta e verifichiamo sulla catena che sia arrivata. Poiché il tuo denaro non è presso di noi non possiamo rimborsare al posto tuo — ed è anche il motivo per cui nessuno può costringerci a farlo.

Posso trattenere un ordine e incassare più tardi?

Sì, dove il contratto di deposito è pubblicato. Il denaro dell’acquirente entra in un contratto anziché nel tuo wallet; lo incassi alla spedizione, per intero o in parte, oppure lo liberi del tutto. Liberarlo ti costa solo le commissioni di rete.

Per quanto tempo posso trattenerlo?

Sette giorni per impostazione predefinita — quanto dura l’autorizzazione di una carta — e fino a trenta se la piattaforma lo consente. Dopodiché l’acquirente riprende il proprio denaro da solo, senza bisogno di noi né di te.

E se l’acquirente paga dopo la scadenza?

Il denaro ti arriva e te lo segnaliamo con l’evento payment.late_settled. Far scadere un pagamento non ferma il wallet dell’acquirente. La decisione è tua: spedire o rimborsare.

E se l’acquirente invia il token sbagliato?

Lo registriamo, ti avvisiamo e lo restituiamo all’indirizzo di rimborso dell’acquirente una volta scaduto il pagamento. Non viene mai conteggiato come pagamento.

E se la mia chiave API viene esposta?

Revocala dal pannello: smette di funzionare all’istante. Una chiave non può creare un’altra chiave, né aggiungere un indirizzo di accredito, né cambiare la destinazione di un pagamento: per farlo serve che una persona acceda al pannello e reinserisca la propria password.

UnifiWallet può congelare i miei fondi?

No, e non è una promessa ma una proprietà dell’architettura. Il denaro è nel tuo wallet, e non ne abbiamo né la chiave né un contratto in grado di spostarlo.

Come faccio a sapere con certezza che un pagamento è avvenuto?

Dal webhook, oppure rileggendo il pagamento dall’API. Mai dal fatto che il browser dell’acquirente sia tornato sulla tua pagina di conferma: visitare un URL non dimostra nulla.

Posso fare prove senza denaro reale?

Sì. Le chiavi di test percorrono la stessa macchina a stati e inviano webhook veri, compresi i casi scomodi: pagamento insufficiente, scadenza, riorganizzazione della catena. Una chiave di test non raggiunge alcun dato reale.

Quali dati conservate sugli acquirenti?

Il minimo indispensabile: un riferimento facoltativo, il paese, l’indirizzo del wallet che ha pagato, e un indirizzo email soltanto se chiedi l’invio di una ricevuta — e in quel caso cifrato.

E se UnifiWallet domani non ci fosse più?

Il denaro che è nel tuo wallet resta dov’è; non siamo mai stati sul suo percorso. I contratti non hanno un proprietario: chiunque può completare un deposito, e l’acquirente può riprendersi una trattenuta scaduta. Ciò che si perde è il servizio, non il denaro.

Documentazione tecnica

La documentazione completa per gli sviluppatori — riferimento dell’API, webhook, esempi di codice e guida introduttiva — è in inglese. È una scelta deliberata: il nome di un campo tradotto smette di funzionare, e un avvertimento su denaro irreversibile addolcito dalla traduzione vale meno di nessun avvertimento.

Guida rapida (in inglese) · Riferimento dell’API · Termini di servizio · Privacy