Payment generator

VeilPay supporta due metodi di pagamento:

Il metodo diretto è il modo più semplice per iniziare ad accettare pagamenti. Generi un link di pagamento e lo invii all'utente. L'utente apre il link e completa la transazione. Questo metodo non richiede l'integrazione con il backend. Tuttavia, poiché i parametri della transazione (importo, indirizzo, ecc.) possono potenzialmente essere modificati dall'utente, dovresti sempre verificare che il pagamento sia stato ricevuto all'indirizzo corretto prima di consegnare beni o servizi.

Il metodo indiretto ti dà maggiore controllo sulla transazione. In questo flusso, crei prima la transazione e ricevi un ID transazione. Presenti poi i dettagli di pagamento all'utente. Poiché la transazione è creata in anticipo, l'utente non può modificare i parametri di pagamento. Questo ti permette anche di tracciare lo stato della transazione usando l'ID transazione. Le transazioni create con questo metodo devono essere avviate entro 72 ore, altrimenti vengono rimosse automaticamente dal database.

Usa il metodo della transazione pre-generata se vuoi:

maggiore controllo sul flusso di pagamento

la possibilità di tracciare lo stato della transazione

protezione più solida contro le modifiche dei parametri

Usa il metodo del link diretto se vuoi:

l'integrazione più veloce

nessuno sviluppo backend

un semplice flusso con link di pagamento

Le transazioni VeilPay sono attualmente limitate all'equivalente di 5 BTC per transazione.

Questo limite aiuta a minimizzare i ritardi di elaborazione e riduce i potenziali rischi legati al KYC.

Se l'utente invia la stessa criptovaluta che hai selezionato per ricevere, non è richiesto alcuno scambio.

Veil non addebita alcuna commissione per queste transazioni.

Se le notifiche via email sono attivate al momento della creazione di una transazione, riceverai una notifica una volta completato il pagamento.

VeilPay non elabora direttamente pagamenti in valuta fiat.

Tuttavia, puoi definire il prezzo di una transazione in valuta fiat (USD, EUR, ecc.).

VeilPay convertirà automaticamente l'importo nel valore equivalente in criptovaluta usando il tasso di cambio corrente.

Il metodo pre-generato (indiretto) è pensato per l'integrazione server-to-server. Il tuo backend crea un pagamento tramite la nostra API REST, riceve un anonpay_id e tu mostri o incorpori il widget VeilPay tramite quell'id. Tutti i parametri di pagamento sono memorizzati dal nostro lato, quindi il cliente non può modificare l'importo, l'indirizzo o qualsiasi altro campo.

Tutti gli endpoint si trovano sotto /api/anonpay sul tuo dominio VeilPay. Sono pubblici — non è richiesta alcuna chiave API o firma per creare un pagamento.

Dal tuo server, invia una richiesta POST a /api/anonpay/prepare con la moneta e la rete che vuoi ricevere, il tuo indirizzo del wallet e l'importo. In questa fase non viene creato alcun ordine — riservi solo un intento di pagamento.

Reindirizza il cliente alla pagina di pagamento per quell'id, oppure incorporala nella tua pagina come iframe. Il widget si apre con l'importo e l'indirizzo bloccati — il cliente sceglie solo con quale moneta pagare.

Controlla lo stato attuale in qualsiasi momento con una richiesta GET. Lo stato passa da prepared → waiting_deposit → deposit_received → exchanging → sending → completed.

Invece di effettuare il polling, passa un URL webhook al momento della creazione del pagamento per ricevere un POST a ogni cambio di stato: