Come funziona
Callback del pagamento
WayForPay invia i dati del pagamento e merchantSignature al Service URL univoco della tua integrazione.
Registrazione del pagamento
Un pagamento riuscito si collega a un orderReference esistente oppure viene salvato a parte per la riconciliazione.
Nessun duplicato
Un evento ripetuto aggiorna lo stesso pagamento, non duplica l’avviso e non inventa mai un ordine.
Verifica della firma
- Algoritmo
- HMAC-MD5 sui campi dell’ordine
- Campo
- merchantSignature
- merchantAccount
- inviato da WayForPay e incluso nella firma; non salvato a parte dal CRM
- Dati della carta
- PAN, recToken, repayUrl e firma non vengono memorizzati
Sicurezza
- merchantSignature viene verificata prima di registrare un pagamento
- SecretKey verifica le firme in ingresso e firma la risposta accept; non viene mai restituita nell’interfaccia
- Registrazione idempotente e corrispondenza per orderReference
- Generazione di un payload di prova firmato
Configurazione
- 1
Aggiungi il connettore WayForPay
Fornisci solo la SecretKey e crea il connettore — i callback funzionano subito. Il Service URL compare nella pagina del connettore, insieme al punto in cui aggiungere il tuo merchantAccount e il dominio del sito: servono per emettere link di pagamento direttamente da un ordine e alimentano la verifica locale facoltativa della firma.
- 2
Aggiungi il Service URL
Per i pagamenti via API, passa serviceUrl in Purchase o wayforpay.run(...). Nel portale: Strumenti di pagamento → Payment Button → Impostazioni avanzate → Service URL.
- 3
Esegui un pagamento di controllo
Puoi generare un esempio locale come diagnostica facoltativa; non attiva l’integrazione. Un pagamento di controllo verifica la configurazione del tuo portale WayForPay e compare in Commercio → Pagamenti o sull’ordine esistente.
Domande frequenti
In cosa differisce da LiqPay?
WayForPay usa HMAC-MD5 su un proprio insieme di campi, incluso merchantAccount. È un contratto specifico del provider, non il flusso di firma di LiqPay.
Posso provare senza un pagamento reale?
Sì. Puoi controllare la SecretKey e la firma in locale senza registrare un pagamento. È facoltativo: gli eventi firmati correttamente vengono accettati subito dopo la creazione. Un pagamento reale o di prova del provider verifica la consegna al Service URL, la registrazione del pagamento e la risposta accept firmata.
L’ordine deve già esistere nel CRM?
No. Se l’ordine esiste già, passa il suo externalId come orderReference e il pagamento si collega a esso. Altrimenti il pagamento viene salvato a parte per la riconciliazione e non crea automaticamente un ordine.
Posso emettere un link di pagamento direttamente dal CRM?
Sì, una volta salvati merchantAccount e dominio del sito nella pagina del connettore: il pulsante «Link di pagamento» su un ordine o una fattura emette allora una fattura WayForPay e restituisce un link che il manager invia all’acquirente. I link restano pagabili per un giorno e il pagamento si collega da solo. Una particolarità di WayForPay: dopo il pagamento, l’acquirente resta sulla pagina dei risultati del provider — il suo metodo di creazione della fattura non accetta un indirizzo di ritorno.
Il CRM può emettere un rimborso o chiudere un blocco?
No. L’integrazione riceve solo l’evento del Service URL e restituisce una risposta accept firmata. Refund, Settle, Charge, fatture e Payment Widget restano in WayForPay o nella tua vetrina.
Collega WayForPay
Segui i pagamenti WayForPay in un unico registro e riconciliali con gli ordini.
Inizia gratis