Salta al contingut principal
seQura

Errors de Payment Provider: seQura a Odoo: un cas de principi a fi

Els missatges de Payment Provider: seQura diuen què falta o què ha rebutjat seQura, i diversos ja indiquen el pas següent: desar junts usuari i contrasenya a FlexigoTech Cloud, fer servir el compte live, enganxar el JSON del simulador de widgets, afegir un mòbil o validar la factura rectificativa abans de retornar. Aquí els recorres seguint una botiga inventada, des que connecta el compte fins que retorna una comanda.

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
6 min

Com llegir els avisos del mòdul

On l'avís posa %s, %(country)s, %(countries)s, %(refunded)s o %(total)s, a la pantalla surt la dada del teu cas: un nom, el valor que has escrit, un país, uns imports o el motiu que dona seQura. Llegeix-lo abans de tornar-ho a provar.

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

Cerámicas Brisa és una botiga inventada que ven vaixella a Espanya i vol oferir pagament ajornat amb seQura des del seu Odoo. La Marta, d'administració, connecta el compte, prepara els widgets, cobra amb enllaç i gestiona una devolució. Aquests són els missatges que es troba, en l'ordre en què li surten.

Connectar el compte a través de FlexigoTech Cloud

Recorregut des de la llista de proveïdors de pagament fins a les pestanyes del proveïdor seQura
De la vista kanban de proveïdors, amb seQura en mode de prova, al formulari amb desplegament i credencials ocultes, la pestanya de comptes i la de mètodes de pagament (dades de demostració)

En desar les credencials, el primer avís és Before saving the seQura username and password, an administrator has to accept that they and the calls to seQura go through FlexigoTech Cloud. Nothing was sent. Un administrador ha d'acceptar que usuari, contrasenya i crides a seQura passen per FlexigoTech Cloud, i no s'ha enviat res. La Marta demana aquesta acceptació a qui administra Odoo.

Després escriu només l'usuari i surt Type both the seQura username and the password: they are saved together. Nothing was sent.: es desen junts, així que cal escriure tots dos. Si intenta connectar abans de desar-los, l'avís és Type your seQura username and password for FlexigoTech Cloud and save before connecting. o Add your seQura username and password before connecting.: escriure, desar i connectar. Si més endavant apareix The seQura username and password of %s are not saved in FlexigoTech Cloud: type them again., torna a escriure'ls. I Connect a seQura account first. indica que abans cal un compte de seQura connectat.

Un cop connectada, la Marta veu seQura accepted the credentials but reported no merchant account for a country Odoo knows. Ask seQura which countries your account covers. Les credencials són vàlides, però seQura no ha retornat cap compte de comerç per a un país que Odoo reconegui. El pas següent el dona el mateix missatge: preguntar a seQura quins països cobreix el compte.

Formulari del proveïdor seQura en mode de prova amb la pestanya seQura accounts oberta i una línia d'Espanya amb Merchant ID i Assets key
Pestanya seQura accounts amb un compte d'Espanya i les URL de notificació i webhook, amb dades de demostració

Passar de sandbox a live

En deixar les proves apareix To go live with %s on FlexigoTech Cloud, type the username and password of your live seQura account: sandbox and live are different accounts. Sandbox i live són comptes diferents, així que s'escriuen les credencials del compte live.

Per canviar el desplegament amb credencials desades, l'avís és Delete the seQura credentials of %s from FlexigoTech Cloud before changing its deployment: the saved ones belong to the current deployment.: primer s'esborren de FlexigoTech Cloud. I el tipus de connexió no es canvia: The connection of a seQura provider does not change: a new provider goes through FlexigoTech Cloud and the ones bought before keep the direct connection.

La configuració completa és a la posada en marxa de seQura.

Widgets, durades i països

Als widgets promocionals, la Marta escriu l'aparença a mà i rep The widget appearance must be the JSON produced by seQura's widget simulator. %s Cal fer servir el JSON que genera el simulador de widgets de seQura, i el %s en dona el detall. Si el valor no és un objecte, l'avís és The widget appearance must be a JSON object.

Formulari del proveïdor seQura en mode de prova amb la pestanya seQura widgets oberta
Pestanya seQura widgets amb el producte pp3, l'aparença en JSON i on mostrar els widgets a producte, cistella i llistats, amb dades de demostració

Per a les durades, %s is not a valid service duration. Use an ISO-8601 duration such as P15D, P3M or P1Y6M. demana una durada ISO-8601, i %s is neither an ISO-8601 duration (P3M, P1Y6M) nor a date (2027-06-30). admet també una data amb la forma 2027-06-30. En tots dos, el %s és el que has escrit.

Amb un país que no encaixa surt seQura does not sell in %(country)s. It operates in %(countries)s., que ja enumera els països on opera seQura.

Formulari del proveïdor seQura en mode de prova amb la pestanya de mètodes de pagament oberta i el botó Refresh
Pestanya de mètodes de pagament amb una fila d'Espanya, pp3, Paga Fraccionado i part_payment, amb dades de demostració

Cobrar amb enllaç de pagament

Amb la comanda buida, en enviar l'enllaç la Marta veu Add something to the order before sending a payment link. Afegeix les línies i surt A mobile number is needed: seQura sends the link by SMS.: el client necessita un mòbil. seQura cannot finance this order: %s i seQura could not send the link: %s porten el motiu de seQura al %s. seQura could not be reached: %s indica que no s'ha pogut contactar amb seQura, i This transaction has not reached seQura yet., que la transacció encara no ha arribat a seQura.

En gestionar el pagament, Only a seQura payment that is waiting can be confirmed this way. surt si el pagament no està en espera. seQura refused the capture: %s i seQura refused the void: %s donen el motiu del rebuig de la captura o de l'anul·lació.

Amb una comanda antiga, la Marta veu This order was created in seQura's test environment and this account is now live, so seQura has never seen it here. There is nothing to do on seQura's side: no real money moved. Cancel the order in Odoo instead. La comanda es va crear en proves, no es va moure diners reals i es cancel·la a Odoo.

Retornar una comanda amb una factura rectificativa

Una clienta retorna un plat. Des de la factura, la Marta rep Only a credit note can be refunded through seQura.: la devolució va per factura rectificativa. Amb la factura rectificativa sense validar: Post the credit note first.

Si no hi ha cap pagament liquidat vinculat al document, surt No settled seQura payment is linked to this document. Sense import pendent, l'avís és There is nothing left to refund on this seQura order. o There is nothing left to refund on this seQura order: %(refunded)s of %(total)s has already been returned., que mostra el que s'ha retornat davant del total. Si seQura la rebutja, seQura did not accept the refund. See the transaction %s for the reason. et remet a aquesta transacció per veure'n el motiu.

Liquidacions i comandes sense parella

seQura could not report your payouts: %s indica que seQura no ha pogut informar de les liquidacions, amb el motiu al %s. No Odoo sales order matches %s. diu que cap comanda de venda d'Odoo coincideix amb la dada del %s. Per veure què recorre cada registre, llegeix com funciona el mòdul per dins.

Què s'aprèn del cas

  • Sandbox i live són comptes diferents: les credencials no es reutilitzen i una comanda de proves es cancel·la a Odoo.
  • Usuari i contrasenya es desen junts a FlexigoTech Cloud, després de l'acceptació d'un administrador.
  • En els rebuigs, el motiu és al %s o a la transacció citada.
  • Les devolucions surten d'una factura rectificativa validada i vinculada a un pagament liquidat.
  • L'aparença dels widgets és el JSON del simulador; les durades, ISO-8601 o data.

Com t'ajuda FlexigoTech

La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla; si seQura canvia la seva API, s'adapten el mòdul i el servei. El mòdul costa 9 € sense IVA per versió d'Odoo, pagament únic, per a 17, 18, 19 i 20 a Odoo Apps, i la connexió va amb el pla Connector, disponible a la pàgina del mòdul. Si a més necessites implantar Odoo o una integració a mida, també ho fem.

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.Posada en marxa de Payment Provider: seQura a Odoo, pas a pas amb un casCom posar en marxa Payment Provider: seQura a Odoo: compte per país, Merchant ID, Assets key, webhooks signats, mètodes de pagament i què revisar la primera setmana.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