Naar hoofdinhoud
seQura

Payment Provider: seQura in Odoo inrichten, stap voor stap met een voorbeeld

Om Payment Provider: seQura in Odoo in te richten vul je per land van de koper een merchantreferentie in met de Merchant ID, de Assets key en de instellingen voor ondertekende webhooks, en daarna controleer je de betaalmethoden: categorie, minimum- en maximumbedrag, winkelmandbereik en beschikbaarheidsdata. We lopen het door met een verzonnen winkel, van het eerste scherm tot wat je de eerste week het best nakijkt.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 4 november 2026

In het kort

Module
seQura
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
5 min

Ciclos Montseny wil betalingen ontvangen met seQura

Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.

Ciclos Montseny is een verzonnen winkel die fietsen en onderdelen verkoopt via Odoo en seQura wil aanbieden aan kopers in Spanje. Marta, die de winkel runt, installeert Payment Provider: seQura via de modulepagina en neemt het Connector-abonnement, omdat de koppeling via FlexigoTech Cloud loopt: de dienst bewaart de inloggegevens versleuteld, bewaakt de synchronisatie en stuurt een e-mail als die mislukt. Alles hieronder doet ze met de provider in testmodus.

Rondleiding door Betaalproviders met seQura in testmodus: kaart in de kanban, formulier met inloggegevens, tabblad seQura accounts en tabblad betaalmethoden
Met demodata: de seQura-kaart met de labels Test Mode en Published, het formulier met verborgen inloggegevens en de knop Fetch merchant accounts, het tabblad seQura accounts met een regel voor Spanje en het tabblad betaalmethoden met een rij part_payment en de knop Refresh.

Stap één: de merchantreferentie per land

In de animatie zie je het tabblad seQura accounts met een regel voor Spanje, de bijbehorende Merchant ID en Assets key. Marta loopt de velden van dat account een voor een na:

  • Country (country_id): het land van de koper waarvoor deze merchantreferentie geldt.
  • Merchant ID (merchant_ref): de merchantreferentie die seQura haar voor dat land heeft gegeven.
  • Assets key (assets_key): nodig voor de promotiewidgets; seQura geeft hem samen met de inloggegevens door.
  • Signed webhooks (verify_signature): geeft aan of seQura de webhook-events die het naar dit account stuurt ondertekent.
  • Signature secret (signature_secret): wordt gebruikt om te controleren of webhook-events echt van seQura komen.

Omdat de promotiewidgets de Assets key nodig hebben, kopieert Marta die meteen zodra seQura hem met de inloggegevens meestuurt, in plaats van het uit te stellen.

Het detail dat Marta noteert: Signed webhooks en Signature secret horen bij elkaar. Het eerste zegt of seQura de events van dat account ondertekent; het tweede is waarmee je controleert dat een event van seQura komt. Ze checkt dat beide overeenkomen met wat seQura haar voor haar account heeft doorgegeven.

Stap twee: de betaalmethoden goed lezen

In de animatie toont het tabblad betaalmethoden een rij voor Spanje met de categorie part_payment. Elke methode bewaart deze velden, en Marta leest ze voordat ze iets publiceert:

  • Product (product_code) en Campaign (campaign): het product en de campagne van de methode.
  • Category (category): een van deze waarden: pay_now, pay_later of part_payment.
  • Title, Long title, Claim, Description en Cost description: de teksten die de methode bewaart.
  • Icon (SVG) (icon_svg): het pictogram van de methode in SVG-formaat.
  • Minimum amount en Maximum amount: het minimum- en maximumbedrag van de methode.
  • Basket range (limits_display): de winkelmandgroottes waarvoor dit product aangeboden mag worden.
  • Available from en Available until: de begin- en einddatum van de beschikbaarheid.

Er zijn nog drie velden die Marta vindt maar niet zelf interpreteert: Covers services (allows_services), Contract options (contract_options) en Confirmation path (confirmation_path), in de definitie waarvan de waarde down_payment_on_confirmation voorkomt. Heb je daar vragen over, lees dan verder in het artikel over hoe de module onder de motorkap werkt.

Stap drie: de promotiewidgets

Met het account voor Spanje compleet opent Marta het tabblad seQura widgets om te bepalen waar ze getoond worden. Eerst checkt ze dat de Assets key is ingevuld, want dat is het veld dat de promotiewidgets nodig hebben.

Formulier van de seQura-provider in testmodus met het tabblad seQura widgets open
Tabblad seQura widgets: opties voor de promotiewidgets, product, weergave in JSON en waar ze verschijnen op product-, winkelmand- en overzichtspagina's. Met demodata.

Stap vier: wat degene die afletterd te zien krijgt

De module bevat ook een onderdeel voor seQura-uitbetalingen, met menu's voor operaties, financiën en configuratie. Marta laat het met de demoschermafbeeldingen zien aan wie de boekhouding doet, zodat die weet welke schermen eraan komen.

Lijst met seQura-uitbetalingen met één demorecord
Lijst met uitbetalingen: uitgiftedatum, referentie, overgemaakt bedrag, commissies, afgeletterde orders en bedrijf. Met demodata (Wizard Phone).
Formulier van een seQura-uitbetaling met bedragen, commissies en een tabel met verrekenregels
Formulier van een uitbetaling met datum, overgemaakte bedragen, commissies, provider, configuratie en bedrijf, plus het tabblad Settlement lines met vijf orders en hun totalen. Met demodata.

De eerste week: wat Marta controleert

Als de provider eenmaal draait, trekt Marta om de paar dagen even tijd uit om dit na te lopen:

  • Dat het account voor Spanje de juiste Country heeft en de Merchant ID die seQura voor dat land gaf.
  • Dat de Assets key nog is ingevuld als de winkel promotiewidgets gebruikt.
  • Dat Signed webhooks en Signature secret overeenkomen met wat seQura voor het account aangeeft.
  • Dat elke betaalmethode de Category heeft die ze verwacht, en dat Minimum amount, Maximum amount en Basket range passen bij wat ze verkoopt.
  • Dat geen methode die ze wil aanbieden een Available until heeft die al verstreken is.
  • Haar mailbox: FlexigoTech Cloud stuurt een e-mail als de synchronisatie mislukt, dus Marta filtert die meldingen niet weg.

Ziet ze een melding die ze niet begrijpt, dan zoekt ze die op in de lijst met foutmeldingen en waarschuwingen van de module, met de letterlijke tekst van elke melding.

Wat je uit dit voorbeeld haalt

Het inrichten bestaat uit twee blokken: het account per land (merchantreferentie, Assets key en ondertekende webhooks) en de betaalmethoden met hun bedragen, winkelmandbereik en data. Is het eerste blok compleet, dan is het tweede een kwestie van elk veld rustig doorlezen.

Het is ook goed om te weten wat er met het abonnement gebeurt: zonder abonnement, of als de dienst is opgeschort, stopt wat het abonnement levert, maar je gegevens blijven in je Odoo. En als seQura zijn API wijzigt, worden de module en de dienst aangepast.

Hoe FlexigoTech je helpt

Payment Provider: seQura staat op Odoo Apps voor Odoo 17, 18, 19 en 20, voor € 9 per Odoo-versie (eenmalige betaling, excl. btw), en de koppeling loopt via het Connector-abonnement van FlexigoTech Cloud: € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 accounts op het platform. Met het abonnement krijg je de module voor nieuwe Odoo-versies erbij als je hem op flexigotech.com hebt gekocht; in de Odoo App Store koop je elke versie daar. Bekijk het op de Odoo Apps-pagina.

Ben je Odoo nog aan het implementeren? FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat, dus we kunnen seQura als onderdeel van het project voor je inrichten.

Lees verder

Zo werkt Payment Provider: seQura in Odoo: menu's, geplande acties en recordsWelke menu's Payment Provider: seQura aan Odoo toevoegt, welke geplande acties dagelijks of wekelijks draaien en waar je orders, betalingen en uitbetalingen ziet.Fouten van Payment Provider: seQura in Odoo: een voorbeeld van begin tot eindDe foutmeldingen van Payment Provider: seQura in Odoo letterlijk: wanneer elke melding verschijnt en wat je doet, uitgelegd aan de hand van een voorbeeld.Je ontvangt betalingen via seQura maar gebruikt nog geen Odoo: zes mythes over de connectorBetalingen via seQura maar nog geen Odoo? Wat de connector Payment Provider: seQura vraagt, wat het abonnement dekt en waar je begint met de implementatie.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen