Vai al contenuto principale
seQura

Configurare Payment Provider: seQura in Odoo, passo dopo passo con un caso pratico

Per configurare Payment Provider: seQura in Odoo compili, per ogni paese dell'acquirente, un riferimento esercente con il suo Merchant ID, la sua Assets key e le impostazioni dei webhook firmati, poi controlli i metodi di pagamento: categoria, importi minimo e massimo, fascia di carrello e date di disponibilità. Lo vediamo con un negozio inventato, dalla prima schermata fino a cosa conviene guardare nella prima settimana.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 4 novembre 2026

In breve

Modulo
seQura
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0 · nelle fonti collegate in fondo
Lettura
5 min

Ciclos Montseny vuole incassare con seQura

Esempio Caso illustrativo: l'azienda e i suoi dati sono inventati per spiegare il flusso.

Ciclos Montseny è un negozio inventato che vende biciclette e ricambi da Odoo e vuole offrire seQura ai suoi acquirenti in Spagna. Marta, che lo gestisce, installa Payment Provider: seQura dalla pagina del modulo e sottoscrive il piano Connettore, perché la connessione passa da FlexigoTech Cloud: il servizio conserva le credenziali cifrate, monitora la sincronizzazione e avvisa via e-mail se qualcosa non va. Tutto quello che segue lo fa con il fornitore in modalità di test.

Panoramica dei Fornitori di pagamento con seQura in modalità di test: scheda nel kanban, modulo con le credenziali, scheda seQura accounts e scheda dei metodi di pagamento
Con dati dimostrativi: la scheda di seQura con le etichette Test Mode e Published, il modulo con le credenziali nascoste e il pulsante Fetch merchant accounts, la scheda seQura accounts con una riga per la Spagna e la scheda dei metodi di pagamento con una riga part_payment e il pulsante Refresh.

Passo uno: il riferimento esercente di ogni paese

Nell'animazione si vede la scheda seQura accounts con una riga per la Spagna, il suo Merchant ID e la sua Assets key. Marta controlla i campi di quell'account uno per uno:

  • Country (country_id): il paese dell'acquirente a cui serve quel riferimento esercente.
  • Merchant ID (merchant_ref): il riferimento esercente che seQura le ha assegnato per quel paese.
  • Assets key (assets_key): la richiedono i widget promozionali, e seQura la comunica insieme alle credenziali.
  • Signed webhooks (verify_signature): indica se seQura firma gli eventi webhook che invia a questo account.
  • Signature secret (signature_secret): serve a verificare che gli eventi webhook arrivino davvero da seQura.

Dato che i widget promozionali richiedono la Assets key, Marta la copia appena seQura gliela invia con le credenziali, senza rimandare.

Il dettaglio che Marta si annota: Signed webhooks e Signature secret vanno insieme. Il primo dice se seQura firma gli eventi di quell'account; il secondo è ciò che si usa per verificare che l'evento arrivi da seQura. Controlla che entrambi riflettano quanto seQura le ha indicato per il suo account.

Passo due: leggere bene i metodi di pagamento

Nell'animazione, la scheda dei metodi di pagamento mostra una riga per la Spagna con la categoria part_payment. Ogni metodo memorizza questi campi, e Marta li legge prima di pubblicare qualsiasi cosa:

  • Product (product_code) e Campaign (campaign): il prodotto e la campagna del metodo.
  • Category (category): uno di questi valori, pay_now, pay_later o part_payment.
  • Title, Long title, Claim, Description e Cost description: i testi memorizzati nel metodo.
  • Icon (SVG) (icon_svg): l'icona del metodo in formato SVG.
  • Minimum amount e Maximum amount: gli importi minimo e massimo del metodo.
  • Basket range (limits_display): le dimensioni di carrello per cui si può offrire questo prodotto.
  • Available from e Available until: le date di inizio e fine disponibilità.

Ci sono altri tre campi che Marta individua ma non interpreta da sola: Covers services (allows_services), Contract options (contract_options) e Confirmation path (confirmation_path), nella cui definizione compare il valore down_payment_on_confirmation. Se hai dubbi su questi campi, l'articolo su come funziona il modulo dall'interno è il posto giusto per approfondire.

Passo tre: i widget promozionali

Con l'account della Spagna completo, Marta apre la scheda seQura widgets per decidere dove mostrarli. Prima verifica che la Assets key sia compilata, perché è il campo richiesto dai widget promozionali.

Modulo del fornitore seQura in modalità di test con la scheda seQura widgets aperta
Scheda seQura widgets: opzioni dei widget promozionali, prodotto, aspetto in JSON e dove mostrarli su prodotto, carrello ed elenchi. Con dati dimostrativi.

Passo quattro: cosa vedrà chi riconcilia

Il modulo include anche una sezione dedicata agli accrediti di seQura, con menu di operazioni, finanza e configurazione. Marta la mostra a chi segue la contabilità usando le schermate dimostrative, così sa quali pagine troverà.

Elenco degli accrediti seQura con un solo record dimostrativo
Elenco degli accrediti: data di emissione, riferimento, importo trasferito, commissioni, ordini riconciliati e azienda. Con dati dimostrativi (Wizard Phone).
Modulo di un accredito seQura con importi, commissioni e tabella delle righe di liquidazione
Modulo di un accredito con data, importi trasferiti, commissioni, fornitore, configurazione e azienda, e la scheda Settlement lines con cinque ordini e i relativi totali. Con dati dimostrativi.

La prima settimana: cosa controlla Marta

Con il fornitore ormai attivo, Marta si ritaglia qualche minuto ogni pochi giorni per ripassare questi punti:

  • Che l'account della Spagna abbia il Country corretto e il Merchant ID che seQura ha assegnato per quel paese.
  • Che la Assets key sia ancora compilata se il negozio usa i widget promozionali.
  • Che Signed webhooks e Signature secret corrispondano a quanto indicato da seQura per l'account.
  • Che ogni metodo di pagamento abbia la Category attesa, e che Minimum amount, Maximum amount e Basket range siano coerenti con ciò che vende.
  • Che nessun metodo che vuole offrire abbia un Available until già passato.
  • La posta: FlexigoTech Cloud avvisa via e-mail se la sincronizzazione fallisce, quindi Marta non filtra questi avvisi.

Se compare un messaggio che non capisce, lo cerca nell'elenco dei messaggi di errore e avvisi del modulo, con il testo letterale di ciascuno.

Cosa imparare dal caso

La configurazione si articola in due blocchi: l'account per paese (riferimento esercente, Assets key e webhook firmati) e i metodi di pagamento con i loro importi, fascia di carrello e date. Se il primo blocco è completo, il secondo è solo questione di leggere ogni campo con calma.

Conviene anche sapere cosa succede con l'abbonamento: senza abbonamento, o con il servizio sospeso, si ferma ciò che l'abbonamento offre, ma i dati restano nel tuo Odoo. E se seQura cambia la sua API, il modulo e il servizio vengono adeguati.

Come ti aiuta FlexigoTech

Payment Provider: seQura è pubblicato su Odoo Apps per Odoo 17, 18, 19 e 20, a 9 € per versione di Odoo (pagamento una tantum, IVA esclusa), e la connessione funziona con il piano Connettore di FlexigoTech Cloud: 49 €/mese o 490 €/anno IVA esclusa, con fino a 3 account della piattaforma. Con l'abbonamento, il modulo per le nuove versioni di Odoo è incluso se l'hai acquistato su flexigotech.com; sull'Odoo App Store, ogni versione si acquista lì. Puoi vederlo nella scheda di Odoo Apps.

Se stai ancora implementando Odoo, FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura, quindi possiamo lasciarti seQura già configurato come parte del progetto.

Continua a leggere

Come funziona Payment Provider: seQura in Odoo: menu, azioni pianificate e recordQuali menu aggiunge Payment Provider: seQura a Odoo, quali azioni pianificate girano ogni giorno o ogni settimana e dove vedi ordini, pagamenti e liquidazioni.Errori di Payment Provider: seQura in Odoo: un caso dall'inizio alla fineI messaggi di errore di Payment Provider: seQura in Odoo con il testo letterale: quando compare ciascuno e cosa fare, seguiti in un caso illustrativo.Incassi con seQura e non usi ancora Odoo: sei miti sul connettoreIncassi con seQura e non usi ancora Odoo? Cosa richiede il connettore Payment Provider: seQura, cosa include l'abbonamento e da dove iniziare.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti