Salta al contingut principal
seQura

Posada en marxa de Payment Provider: seQura a Odoo, pas a pas amb un cas

Per posar en marxa Payment Provider: seQura a Odoo omples, per a cada país del comprador, una referència de comerciant amb el seu Merchant ID, la seva Assets key i la configuració de webhooks signats, i després revises els mètodes de pagament: categoria, imports mínim i màxim, rang de cistella i dates de disponibilitat. Ho recorrem amb una botiga inventada, des de la primera pantalla fins al que convé mirar la primera setmana.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Mòdul
seQura
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Ciclos Montseny vol cobrar amb seQura

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Ciclos Montseny és una botiga inventada que ven bicicletes i recanvis des d'Odoo i vol oferir seQura als seus compradors d'Espanya. La Marta, que la porta, instal·la Payment Provider: seQura des de la pàgina del mòdul i contracta el pla Connector, perquè la connexió passa per FlexigoTech Cloud: el servei desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Tot el que ve a continuació ho fa amb el proveïdor en mode de prova.

Recorregut per Proveïdors de pagament amb seQura en mode de prova: targeta al kanban, formulari amb credencials, pestanya seQura accounts i pestanya de mètodes de pagament
Amb dades de demostració: la targeta de seQura amb les etiquetes Test Mode i Published, el formulari amb les credencials ocultes i el botó Fetch merchant accounts, la pestanya seQura accounts amb una línia d'Espanya i la pestanya de mètodes de pagament amb una fila part_payment i el botó Refresh.

Pas u: la referència de comerciant de cada país

A l'animació es veu la pestanya seQura accounts amb una línia per a Espanya, el seu Merchant ID i la seva Assets key. La Marta revisa els camps d'aquest compte un per un:

  • Country (country_id): el país del comprador al qual serveix aquesta referència de comerciant.
  • Merchant ID (merchant_ref): la referència de comerciant que seQura li ha emès per a aquest país.
  • Assets key (assets_key): la requereixen els widgets promocionals, i seQura la comunica juntament amb les credencials.
  • Signed webhooks (verify_signature): indica si seQura signa els esdeveniments de webhook que envia a aquest compte.
  • Signature secret (signature_secret): s'utilitza per verificar que els esdeveniments de webhook vénen de debò de seQura.

Com que els widgets promocionals requereixen la Assets key, la Marta la copia tan bon punt seQura li passa amb les credencials, sense deixar-ho per més tard.

El detall que la Marta apunta: Signed webhooks i Signature secret van junts. El primer diu si seQura signa els esdeveniments d'aquest compte; el segon és el que s'utilitza per comprovar que l'esdeveniment ve de seQura. Revisa que tots dos reflecteixin el que seQura li ha indicat per al seu compte.

Pas dos: llegir bé els mètodes de pagament

A l'animació, la pestanya de mètodes de pagament mostra una fila per a Espanya amb la categoria part_payment. Cada mètode desa aquests camps, i la Marta els llegeix abans de publicar res:

  • Product (product_code) i Campaign (campaign): el producte i la campanya del mètode.
  • Category (category): un d'aquests valors, pay_now, pay_later o part_payment.
  • Title, Long title, Claim, Description i Cost description: els textos que desa el mètode.
  • Icon (SVG) (icon_svg): la icona del mètode en format SVG.
  • Minimum amount i Maximum amount: els imports mínim i màxim del mètode.
  • Basket range (limits_display): les mides de cistella per a les quals es pot oferir aquest producte.
  • Available from i Available until: les dates d'inici i de fi de disponibilitat.

Hi ha tres camps més que la Marta localitza però no interpreta pel seu compte: Covers services (allows_services), Contract options (contract_options) i Confirmation path (confirmation_path), en la definició del qual apareix el valor down_payment_on_confirmation. Si tens dubtes amb aquests camps, l'article sobre com funciona el mòdul per dins és el lloc per continuar.

Pas tres: els widgets promocionals

Amb el compte d'Espanya complet, la Marta obre la pestanya seQura widgets per decidir on mostrar-los. Abans comprova que la Assets key està emplenada, perquè és el camp que requereixen els widgets promocionals.

Formulari del proveïdor seQura en mode de prova amb la pestanya seQura widgets oberta
Pestanya seQura widgets: opcions dels widgets promocionals, producte, aparença en JSON i on mostrar-los a producte, cistella i llistats. Amb dades de demostració.

Pas quatre: el que veurà qui concilia

El mòdul inclou també un apartat de desemborsaments de seQura, amb menús d'operacions, finances i configuració. La Marta l'ensenya a la persona que porta la comptabilitat amb les captures de demostració, perquè sàpiga quines pantalles es trobarà.

Llista de desemborsaments seQura amb un únic registre de demostració
Llista de desemborsaments: data d'emissió, referència, import transferit, comissions, comandes conciliades i companyia. Amb dades de demostració (Wizard Phone).
Formulari d'un desemborsament seQura amb imports, comissions i taula de línies de liquidació
Formulari d'un desemborsament amb data, imports transferits, comissions, proveïdor, configuració i companyia, i la pestanya Settlement lines amb cinc comandes i els seus totals. Amb dades de demostració.

La primera setmana: què revisa la Marta

Amb el proveïdor ja en marxa, la Marta es reserva una estona cada pocs dies per repassar això:

  • Que el compte d'Espanya té el Country correcte i el Merchant ID que seQura va emetre per a aquest país.
  • Que la Assets key continua emplenada si la botiga fa servir widgets promocionals.
  • Que Signed webhooks i Signature secret coincideixen amb el que seQura indica per al compte.
  • Que cada mètode de pagament té la Category que espera, i que Minimum amount, Maximum amount i Basket range quadren amb el que ven.
  • Que cap mètode que vulgui oferir no té un Available until ja passat.
  • El correu: FlexigoTech Cloud avisa per correu si falla la sincronització, així que la Marta no filtra aquests avisos.

Si apareix un missatge que no entén, el busca a la llista de missatges d'error i avisos del mòdul, amb el text literal de cadascun.

Què aprendre del cas

La posada en marxa s'organitza en dos blocs: el compte per país (referència de comerciant, Assets key i webhooks signats) i els mètodes de pagament amb els seus imports, rang de cistella i dates. Si el primer bloc està complet, el segon és qüestió de llegir cada camp amb calma.

També convé saber què passa amb la subscripció: sense ella, o amb el servei suspès, s'atura el que dona la subscripció, però les dades es queden al teu Odoo. I si seQura canvia la seva API, s'adapten el mòdul i el servei.

Com t'ajuda FlexigoTech

Payment Provider: seQura està publicat a Odoo Apps per a Odoo 17, 18, 19 i 20, a 9 € per versió d'Odoo (pagament únic, sense IVA), i la connexió va amb el pla Connector de FlexigoTech Cloud: 49 €/mes o 490 €/any sense IVA, amb fins a 3 comptes de la plataforma. Amb la subscripció, el mòdul per a les versions noves d'Odoo hi va inclòs si el vas comprar a flexigotech.com; a l'Odoo App Store, cada versió es compra allà. Pots veure-ho a la fitxa d'Odoo Apps.

Si encara estàs implantant Odoo, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida, així que podem deixar seQura configurat com a part del projecte.

Continua llegint

Com funciona Payment Provider: seQura a Odoo: menús, tasques programades i registresQuins menús afegeix Payment Provider: seQura a Odoo, quines tasques programades s'executen cada dia o cada setmana i on veus comandes, pagaments i liquidacions.Errors de Payment Provider: seQura a Odoo: un cas de principi a fiEls missatges d'error de Payment Provider: seQura a Odoo amb el text literal: quan surt cadascun i què cal fer, recorreguts en un cas il·lustratiu.Cobres amb seQura i encara no fas servir Odoo: sis mites sobre el connectorSi cobres amb seQura i encara no fas servir Odoo: què demana el connector Payment Provider: seQura, què inclou la subscripció i per on començar.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts