Crea il connettore Hutko
In Impostazioni → Integrazioni → Connettori delle piattaforme scegli Hutko, inserisci il merchant ID e la chiave di pagamento in campi separati, poi seleziona Crea.
L’integrazione con Hutko sincronizza gli esiti dei pagamenti della tua attività con Obriym CRM. I dati delle carte e i fondi restano presso Hutko: dopo il pagamento, il servizio invia un messaggio server protetto e il CRM convalida il Merchant ID e la firma SHA1 prima di registrare qualsiasi cosa.
Come viene registrato un pagamento
Il CRM verifica il messaggio di Hutko, salva il pagamento e mostra subito se è stato associato a un ordine.
Callback firmato
Hutko invia l’esito del pagamento all’URL univoco generato per la tua integrazione.
Verifica del merchant
Il merchant_id del callback deve coincidere con il merchant Hutko configurato.
Registrazione del pagamento
Il CRM salva l’importo definitivo e la valuta nel registro dei pagamenti e non inventa mai un ordine a partire dal solo pagamento.
Riconciliazione
Un ordine esistente interamente coperto può passare a Confermato; un pagamento non associato resta nel registro.
Contratto tecnico
Si configura in Impostazioni → Integrazioni → Connettori delle piattaforme.
- Endpoint del CRM
- POST /api/v1/adapters/hutko/{configId}
- Credenziali
- {"merchantId":"1703986","password":"..."}
- Firma
- SHA1 sui campi non vuoti del callback ordinati, con la password del merchant
- Dati conservati
- ordine, stato del pagamento, importo, valuta, id del provider, email/telefono dell’acquirente facoltativi
Modello di sicurezza
- Rifiuta i callback con un merchant_id diverso
- Rifiuta i payload non firmati o firmati in modo errato
- Non conserva PAN, CVV né token grezzi delle carte
- Oscura i metadati sensibili di Hutko prima di salvare la diagnostica
- Una verifica locale facoltativa convalida i dati salvati e la firma senza creare un pagamento
Il CRM registra l’esito; non controlla il pagamento
Il CRM riceve gli stati created, processing, approved, declined, expired e reversed e registra l’importo definitivo e la valuta. Se order_id corrisponde a un ordine esistente, il pagamento viene collegato a quell’ordine; senza corrispondenza, resta in Commercio → Pagamenti per la riconciliazione. L’integrazione non crea ordini e non addebita né rimborsa mai denaro. Un link di pagamento Hutko si genera dalla scheda dell’ordine con il pulsante «Link di pagamento». Non conserva inoltre mai PAN, CVV o token delle carte.
Configurazione
Incolla l’URL nel portale Hutko
Per tutti i pagamenti del merchant: Impostazioni del merchant → Impostazioni di pagamento → Server callback URL. Per un singolo link: Soluzioni di pagamento → Link di pagamento → Funzionalità avanzate → Server callback URL. Il valore del link sovrascrive quello predefinito del merchant.
Oppure passa l’URL tramite API
Se il tuo sito o backend crea il checkout, passa l’URL generato come server_callback_url in ogni richiesta.
Esegui un pagamento di controllo
La verifica locale della connessione è facoltativa. Per verificare la configurazione del tuo portale Hutko, paga con un nuovo order_id e controlla Commercio → Pagamenti; per collegarlo a un ordine esistente, passa il suo externalId.
Domande frequenti
È la stessa integrazione Hutko usata per gli abbonamenti di Obriym?
No. Questa integrazione serve per i pagamenti dei tuoi clienti. La fatturazione degli abbonamenti di Obriym è separata e non si mescola mai con il tuo registro dei pagamenti.
I pagamenti ricorrenti verranno gestiti qui?
No. L’integrazione registra solo gli esiti dei pagamenti. Checkout, addebiti, rimborsi e pagamenti ricorrenti restano in Hutko.
E se Hutko non invia l’email dell’acquirente?
Il pagamento viene comunque registrato. Email o telefono dell’acquirente sono conservati solo se Hutko li invia davvero; la diagnostica sicura mostra solo se quei campi erano presenti, mai i loro valori.
Un callback crea un ordine?
No. Se order_id corrisponde all’externalId di un ordine esistente, il pagamento viene collegato a quell’ordine. Altrimenti viene salvato a parte per la riconciliazione.
Dov’è il campo del callback nel portale Hutko?
A livello globale: Impostazioni del merchant → Impostazioni di pagamento → Server callback URL. Per un singolo link di pagamento, apri le sue Funzionalità avanzate; l’URL lì sovrascrive il valore a livello di merchant.
Collega gli stati di pagamento di Hutko
Registra i pagamenti Hutko confermati e riconciliali con gli ordini senza creare duplicati.
Inizia gratis