È Monobank a muovere il denaro — il CRM non tocca mai una carta e non addebita nulla. Il suo compito è diverso e non meno importante: sentire dalla banca che una determinata fattura è stata pagata e riportare quel fatto su un determinato ordine, così il tuo manager lo vede senza aprire l’area acquiring. Ogni conferma viene controllata con una firma crittografica, quindi un «pagato» falsificato non passa. Un webhook rinviato non crea mai un secondo pagamento.
Come funziona
Webhook firmato
Monobank invia lo stato della fattura con un header x-sign. Il CRM legge il corpo grezzo della richiesta e verifica la firma ECDSA con la chiave pubblica del tuo merchant — altrimenti non accetta nulla.
Pagamento sull’ordine
Viene creato un record di pagamento con importo, valuta, metodo e stato, collegato all’ordine tramite il reference della fattura.
Stato dell’ordine
L’ordine passa a «Confermato» se è ancora «In attesa» e i pagamenti coprono il totale dell’ordine.
Il tuo team viene avvisato
Un pagamento riuscito genera una notifica nella campanella e un push per il titolare e i manager — esattamente una, anche se la banca l’ha rinviata.
Registro dei pagamenti
Tutti i pagamenti di tutti i provider in un unico elenco con ricerca, filtri e stato del collegamento. Puoi vedere cosa è stato pagato anche quando non esiste ancora un ordine.
Il pagamento parziale è visibile
La fattura mostra uno stato derivato — non pagata, parziale o pagata — in base ai pagamenti effettivi nella valuta dell’ordine.
Dove finisce la responsabilità
Esattamente cosa fa il CRM e cosa resta a Monobank e al tuo negozio. Questi confini contano: un’integrazione di pagamento che promette più di quanto fa è il tipo di equivoco più costoso.
- Il CRM accetta
- webhook firmati sullo stato della fattura; Monobank non invia lo stato expired via webhook, quindi lo monitora chi ha creato la fattura
- Il CRM registra
- id della fattura, stato, importo e valuta effettivi; il reference della fattura → l’externalId dell’ordine
- Il CRM può cambiare
- «In attesa» → «Confermato», e solo per un pagamento riuscito che copre l’ordine nella valuta corretta
- Il CRM crea
- una fattura quando un manager preme «Link di pagamento» su un ordine o una fattura — la pagina di pagamento è ospitata da Monobank e il link resta pagabile per un giorno
- Il CRM non fa mai
- annullare fatture, rimborsi, pagamenti divisi, addebitare una carta o conservare dati di carte
- Valute
- Grivna, più dollaro ed euro — la valuta proviene dal codice ISO-4217 numerico nel webhook e gli importi vengono convertiti dalle unità minime
Un pagamento che non ha trovato un ordine non va perso
Il difetto più comune delle integrazioni di pagamento: i soldi sono arrivati, il sistema non sa a cosa collegarli e scarta semplicemente l’evento.
- Se il reference della fattura non corrisponde a nessun ordine, il pagamento viene comunque salvato — in Commercio → Pagamenti, contrassegnato come non collegato.
- Un manager lo apre e lo collega a un ordine esistente oppure crea da esso un nuovo ordine, con acquirente e importo già noti.
- Il percorso inverso funziona anche dall’ordine: scegli dall’elenco un pagamento non collegato esistente.
- Un pagamento può essere registrato a mano — per contanti o bonifici che non sono mai passati dall’acquiring.
- Un webhook rinviato non crea duplicati: il record è idempotente sull’id della fattura.
La verifica dell’account è diagnostica, non una barriera
Il callback funziona nel momento in cui il token del merchant è salvato: un evento correttamente firmato da Monobank si autentica da solo, quindi pretendere «supera prima una verifica» sarebbe un ostacolo artificiale tra te e un pagamento reale. Se vuoi, la verifica della connessione esegue una lettura sicura e mostra a quale account appartiene il token, senza modificare nulla nel CRM.
Configurazione
- 1
Aggiungi il connettore Monobank
Incolla il token del merchant dalla tua area Monobank Acquiring. L’indirizzo del webhook compare nella pagina del connettore creato. Il token è conservato cifrato.
- 2
Passa l’indirizzo in webHookUrl
Il tuo negozio aggiunge quell’indirizzo al campo webHookUrl di ogni richiesta di creazione fattura — l’API ufficiale non descrive alcun webhook globale del merchant. Inserisci l’externalId dell’ordine del CRM in merchantPaymInfo.reference: è così che il pagamento trova il suo ordine.
- 3
Verifica con un pagamento reale
Esegui un pagamento vero. Dovrebbe comparire nel registro e sull’ordine, e il tuo team dovrebbe ricevere la notifica.
Domande frequenti
Come collego Monobank al CRM?
Aggiungi il connettore Monobank in Impostazioni → Integrazioni, incolla il token del merchant dalla tua area acquiring e copia l’indirizzo del webhook. Il tuo negozio poi passa quell’indirizzo nel campo webHookUrl quando crea una fattura — e i pagamenti iniziano a comparire nel CRM.
Mi serve un test separato prima di accettare pagamenti reali?
No. Un evento firmato da Monobank si autentica da solo, quindi i webhook vengono accettati non appena il token è salvato. La verifica della connessione è disponibile come diagnostica ma non è un prerequisito.
Il CRM conserva i dati delle carte?
No. Numero della carta e CVV non raggiungono mai il CRM e non vengono mai conservati. Si conservano solo importo, valuta, stato e id della fattura — abbastanza per riconciliare il pagamento con l’ordine.
Come trova il CRM l’ordine giusto?
Tramite il campo reference della fattura: il tuo negozio vi inserisce l’externalId dell’ordine e il CRM cerca nel tuo spazio di lavoro un ordine con esattamente quell’identificativo. Un webhook non può raggiungere gli ordini di un altro spazio di lavoro.
E se il reference non corrisponde?
Il pagamento non viene scartato. Viene salvato nel registro dei pagamenti come non collegato, e un manager lo collega a un ordine esistente o crea da esso un nuovo ordine.
Il CRM crea fatture o emette rimborsi?
Una fattura sì — quando la richiedi: il pulsante «Link di pagamento» su un ordine o una fattura genera una fattura Monobank e restituisce un link che il manager invia all’acquirente. Rimborsi, annullamento delle fatture e qualsiasi addebito restano a Monobank e al tuo negozio; il CRM non fa nulla di tutto ciò.
Si possono accettare allo stesso modo altri provider?
Sì. LiqPay, WayForPay e Hutko si collegano allo stesso modo e scrivono nello stesso registro dei pagamenti — ciascuno con il proprio schema di firma, esattamente come richiede la documentazione ufficiale del rispettivo provider.
Spesso collegati insieme
LiqPay
BetaUn pagamento confermato da LiqPay genera un unico avviso al team e aggiorna l’ordine corrispondente nel CRM.
Scopri di piùWayForPay
DisponibileIl CRM verifica l’esito di ogni pagamento, avvisa il tuo team e collega il pagamento a un ordine esistente. Senza corrispondenza, resta in una chiara coda di riconciliazione.
Scopri di piùHutko
DisponibileDopo ogni pagamento, il CRM registra l’esito, avvisa il tuo team e collega il pagamento a un ordine esistente oppure lo conserva in una chiara coda di riconciliazione.
Scopri di piùRozetka
BetaIl più grande marketplace dell’Ucraina: gli ordini arrivano da soli nel CRM, stati e giacenze tornano all’area del venditore e le domande degli acquirenti diventano lead con un responsabile e un prossimo passo.
Scopri di piùProm.ua
DisponibileOrdini, pagamenti e consegne arrivano da soli. Le domande degli acquirenti diventano lead a cui rispondi direttamente dal CRM, senza aprire l’area Prom.
Scopri di piùBeta: Beta: collegabile già oggi; le funzionalità del canale sono ancora in fase di rifinitura.
Collega Monobank
I pagamenti acquiring arrivano da soli sui loro ordini — e quelli che non trovano un ordine attendono nel registro invece di sparire.
Inizia gratis