OdooWiki OCA HUB

Payment Provider: EasyPay

payment_easypay_oca folder_open OCA/l10n-portugal open_in_new
Accounting/Payment Providers Licencia: LGPL-3

Este módulo integra EasyPay como proveedor de pago en Odoo, permitiendo a los clientes pagar mediante tarjeta de crédito y otros métodos de pago utilizando la pasarela de pago segura de EasyPay.

EasyPay es un proveedor de servicios de pago portugués que admite múltiples métodos de pago, incluidas tarjetas de crédito, Multibanco, MB WAY, SEPA Direct Debit y más.

Verificado como compatible:

  • Pagos con tarjeta de crédito/débito,
  • Pagos por referencia Multibanco (MB),
  • MB WAY.

Aún no implementado o verificado:

  • SEPA Direct Debit,
  • Pay by Link,
  • Referencia Multibanco en facturas.

Obtenga más información sobre EasyPay en

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Añade EasyPay como proveedor de pago en Odoo, permitiendo a los clientes pagar con tarjeta de crédito, referencia Multibanco, MB WAY y otros métodos. También permite gestionar las credenciales de EasyPay, sincronizar los métodos de pago y configurar webhooks desde el formulario del proveedor.

Este módulo añade EasyPay como una nueva opción de proveedor de pago en la configuración de pagos de Odoo. Una vez habilitado, los clientes pueden pagar en línea con tarjeta de crédito/débito, Multibanco (un pago por referencia portugués), MB WAY y otros métodos compatibles con EasyPay.

En la pantalla de configuración del proveedor de pago obtienes campos específicos de EasyPay: Account ID, API Key, una Webhook Base URL calculada, un interruptor 'Hide Customer Details Form', los días de expiración de Multibanco y el tipo de producto Multibanco. Hay tres botones disponibles: Test Connection, Sync Payment Methods y Configure Webhooks. Sync Payment Methods obtiene los métodos habilitados en tu cuenta de EasyPay y activa solo esos en Odoo. Configure Webhooks registra las URL de callback con EasyPay.

Durante el pago, una página dedicada de EasyPay aloja el formulario de pago. Para Multibanco, una página separada muestra la entidad, la referencia formateada, el importe y la fecha de expiración. Las transacciones de pago almacenan detalles específicos de EasyPay, como el ID de transacción de EasyPay, el ID de checkout, el método de pago, el estado de captura y la entidad/referencia/expiración de Multibanco.

El módulo admite tokenización (guardar un método de pago para más tarde), reembolsos parciales, captura manual y anulación. Los webhooks de EasyPay actualizan el estado del pago automáticamente, y el módulo consulta EasyPay cuando un webhook se retrasa. Solo se admite la moneda EUR.

Depende de

paymentphone_validation
Modelos y campos (3)
  • payment.provider · amplía un modelo existentecode, easypay_api_key (API Key), easypay_account_id (Account ID), easypay_mb_product (MB Product Type), easypay_hide_details (Hide Customer Details Form), easypay_webhook_base_url (Webhook Base URL), easypay_mb_expiration_days (MB Expiration Days)
  • payment.transaction · amplía un modelo existenteeasypay_mb_entity (MB Entity), easypay_checkout_id (EasyPay Checkout ID), easypay_mb_reference (MB Reference), easypay_mb_expiration (MB Expiration), easypay_capture_status (EasyPay Capture Status), easypay_payment_method (EasyPay Payment Method), easypay_transaction_id (EasyPay Transaction ID), easypay_payment_details (EasyPay Payment Details)
  • easypay.payment.method · modelo nuevocode (Method Code), name (Method Name)

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.

Fuentes · Odoo 18.0

Confirmado el 2026-11-03 en la rama 18.0 de OCA/l10n-portugal.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Configuración

Fuente · Odoo 18.0

Requisito de divisa: EasyPay solo admite EUR. El proveedor está preconfigurado para aparecer solo en transacciones en EUR y se ocultará automáticamente cuando la divisa del cliente sea diferente.

  • Crear una cuenta de EasyPay
  • Entorno de prueba: Regístrate en
  • Producción: Regístrate en y completa la verificación de comerciante

Una vez iniciada la sesión, anota tu Account ID y tu API Key (ambos en formato UUID) desde el panel de EasyPay.

  • Configurar el proveedor en Odoo
  • Ve a Contabilidad → Configuración → Proveedores de pago (o Sitio web → Configuración → Proveedores de pago)
  • Busca EasyPay y abre el formulario del proveedor
  • Rellena:
  • Account ID — desde tu panel de EasyPay
  • API Key — desde tu panel de EasyPay (campo solo para administradores)
  • Payment Methods — selecciona los métodos que quieras ofrecer (Credit/Debit Card, Multibanco, MB WAY, etc.)
  • Allow Saving Payment Methods — cuando está habilitado, los clientes que hayan iniciado sesión pueden marcar "Save my payment details" al finalizar la compra para tokenizar su tarjeta o mandato de adeudo directo SEPA para cargos futuros (p. ej. suscripciones). Habilitado por defecto.
  • Establece el State del proveedor:
  • Test Mode → usa https://api.test.easypay.pt y habilita el flag testing en el SDK automáticamente
  • Enabled → usa https://api.prod.easypay.pt (producción)
  • Haz clic en Save
  • Registrar webhooks

EasyPay envía actualizaciones del estado de pago a tres endpoints de Odoo independientes. La forma más sencilla de registrarlos es usar el botón integrado:

  • En el formulario del proveedor EasyPay, haz clic en Configure Webhooks
  • Odoo llamará a PATCH /2.0/config en la API de EasyPay y registrará:
  • https://yourdomain.com/payment/easypay/webhook/generic
  • https://yourdomain.com/payment/easypay/webhook/authorisation
  • https://yourdomain.com/payment/easypay/webhook/transaction

Si necesitas registrar webhooks manualmente en el panel de EasyPay, usa las tres URLs anteriores. Los tres deben estar registrados para que todos los métodos de pago funcionen correctamente (la confirmación de Multibanco, por ejemplo, llega a través del webhook de transacción).

Nota: los webhooks deben ser accesibles desde internet. Si se ejecuta en local, usa un túnel como localtunnel (https://theboroer.github.io/localtunnel-www/) o ngrok y actualiza la URL base de Odoo en consecuencia antes de hacer clic en Configure Webhooks.

  • Probar la conexión

Haz clic en Test Connection en el formulario del proveedor para verificar que tus credenciales son correctas y que se puede acceder a la API de EasyPay.

  • Pasar a producción
  • Sustituye las credenciales de prueba por los valores de producción
  • Cambia el State del proveedor a Enabled
  • Haz clic de nuevo en Configure Webhooks para registrar las URLs de webhook de producción
  • Prueba con un pago real pequeño antes de pasar completamente a producción
  • Establece el proveedor como Published para que los clientes puedan verlo

Uso

Fuente · Odoo 18.0

Una vez configurado, los clientes pueden usar EasyPay para realizar pagos:

  • Durante el checkout, selecciona EasyPay como método de pago
  • Haz clic en Pay Now
  • Se carga un formulario de pago inline seguro. El cliente selecciona un método de pago y completa el pago sin salir del sitio.

Comportamiento de los métodos de pago

  • Credit/Debit Card: El pago se captura inmediatamente. El pedido se confirma en cuanto se cobra la tarjeta.
  • MB WAY: El cliente introduce su número de móvil. Se envía una notificación push a su teléfono para su confirmación. El pedido queda en estado Pending hasta que el usuario confirma (o rechaza) en la app MB WAY.
  • Multibanco: Se muestra una referencia ATM (Entity + Reference + Amount). El cliente paga en cualquier cajero o mediante banca online. El pedido permanece en Pending hasta que se confirma el pago, lo que puede tardar desde minutos hasta días. El cliente no debe cerrar la página de confirmación antes de anotar la referencia.
  • SEPA Direct Debit: El cliente introduce su IBAN y acepta un mandato SEPA que autoriza a EasyPay a adeudar su cuenta. El pedido permanece en Pending hasta que el banco liquida el adeudo (normalmente 2–5 días hábiles). Cuando se usa con tokenización, el mandato se guarda y los cargos posteriores se realizan automáticamente.
  • Virtual IBAN: Se muestra un IBAN dedicado. El cliente transfiere el importe exacto mediante banca online. El pedido permanece en Pending hasta que se recibe la transferencia y EasyPay la concilia.
  • Save payment details (tokenization): Los clientes que han iniciado sesión pueden marcar Save my payment details en el checkout. El método de pago se guarda como token para cargos futuros (p. ej. suscripciones). Esto funciona con tarjetas y SEPA Direct Debit.

Reembolsos

Los reembolsos pueden iniciarse desde el backend de Odoo en cualquier transacción confirmada:

  • Abre la transacción de pago y haz clic en Refund
  • Se envía una solicitud de reembolso a EasyPay y se crea una transacción de reembolso hija en estado Pending
  • Una vez que EasyPay procesa el reembolso, un webhook actualiza la transacción de reembolso a Done (o Error si ha fallado)

Se admiten reembolsos parciales — introduce el importe a reembolsar cuando se solicite.

Datos de tarjeta de prueba (solo entorno de prueba)

Consulta la guía EasyPay Payment Methods para obtener las credenciales de prueba completas de todos los métodos de pago.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.