LiqPay è il servizio di pagamento di PrivatBank. Quando conferma un pagamento dal suo lato, il CRM verifica la firma del callback, registra l’esito sull’ordine e ne sincronizza lo stato.
Come funziona
Callback di pagamento
LiqPay invia data/signature all’endpoint del connettore.
Registrazione del pagamento
Viene creata una voce nel registro dei pagamenti con importo e stato.
Aggiornamento dello stato
L’ordine passa a «Confermato» se era «In attesa».
Sicurezza
- Verifica della firma per entrambe le varianti attualmente presenti nella documentazione ufficiale dei callback di LiqPay: SHA3-256 in base64 nella formula e SHA1 in base64 negli esempi eseguibili
- Nessun dato di carta conservato (PAN/CVV)
- La chiave privata serve solo per firmare — non viene mai restituita nell’interfaccia
- Collegato all’ordine tramite order_id
Convalida facoltativa della configurazione
I callback funzionano non appena la chiave privata è salvata — la verifica non attiva né blocca il connettore. Puoi facoltativamente generare un payload firmato per controllare in locale il segreto e il formato senza registrare un pagamento.
Configurazione
- 1
Aggiungi il connettore LiqPay
Fornisci la chiave privata e crea il connettore. Il suo URL di callback univoco compare solo nella pagina del connettore creato.
- 2
Passa l’URL come server_url
Aggiungi l’URL generato a server_url in ogni richiesta di Checkout/pagamento di LiqPay. result_url è diverso: reindirizza il browser dell’acquirente.
- 3
Verifica in locale, se vuoi
Genera un payload di prova e conferma la firma. È una diagnostica, non un prerequisito per i callback reali.
Domande frequenti
I dati della carta vengono conservati?
No. Conserviamo solo lo stato, l’importo e l’id della transazione — niente PAN/CVV.
Come viene trovato l’ordine giusto?
L’order_id del callback viene confrontato con l’externalId dell’ordine nel CRM.
Il CRM può creare o rimborsare un pagamento LiqPay?
No. Questo connettore si limita a ricevere callback firmati e a registrarne l’esito. Checkout, addebiti, trattenute, rimborsi e chiamate all’API degli stati restano nella vetrina o nell’account LiqPay.
Collega LiqPay
Gli stati di pagamento confermati si sincronizzano automaticamente nell’ordine.
Inizia gratis