Redsys para PrestaShop API

Modelo de integración

Redsys para PrestaShop es un módulo estándar de PrestaShop (PrestaShop 8+, PHP 8.1+). No expone una REST API de transacciones de propósito general: no hay recurso WebserviceRequest ni endpoint JSON público para consultar o modificar transacciones de forma remota. En su lugar, la superficie de integración es la convencional de PrestaShop — front controllers (las URLs de pago, retorno y notificación), controladores de administración (pestañas del back-office), una capa de servicios internos, un registro de capacidades de pago y hooks del módulo.

Si necesitas consultar pedidos o emitir reembolsos de forma programática desde un sistema externo, usa el propio Webservice del núcleo de PrestaShop (el recurso /api) sobre los datos de tu tienda, y personaliza el flujo de Redsys mediante los hooks del módulo. Para automatizar pagos mediante una API dedicada, WooCommerce Redsys Gateway expone una REST API A2A / UCP completa.

Nota: el módulo incluye internamente un RedsysRestService — ese es el cliente que el módulo usa para comunicarse con la propia REST API de Redsys para pagos InSite. No es una API que el módulo exponga a terceros.

URLs de front controller

Los front controllers se encuentran en controllers/front/ y se alcanzan a través del module link de PrestaShop, por ejemplo:

# Built in code with $this->context->link->getModuleLink('ps_redsys_gateway', '<controller>')
https://your-store.com/index.php?fc=module&module=ps_redsys_gateway&controller=<controller>
# or, with friendly URLs enabled
https://your-store.com/module/ps_redsys_gateway/<controller>

Los controladores siguientes son los que un desarrollador suele necesitar conocer. Son visitados por el navegador del comprador o llamados servidor a servidor por Redsys; no son una API de consulta.

Notificación (IPN)

La liquidación del pago la impulsa la notificación firmada servidor a servidor de Redsys, no el navegador del comprador. Esta URL se configura en tu terminal de Redsys (RedsysHMAC) como la "URL de notificación / merchant URL". El módulo la expone a través del front controller ipn.

https://your-store.com/index.php?fc=module&module=ps_redsys_gateway&controller=ipn
# Paygold payment links use a dedicated endpoint
https://your-store.com/index.php?fc=module&module=ps_redsys_gateway&controller=paygoldipn

El controlador verifica la firma HMAC-SHA256 de Redsys en el payload Ds_Signature / Ds_MerchantParameters antes de cambiar cualquier estado de pedido. Alrededor de este procesamiento el módulo dispara los hooks actionRedsysBeforeIPNProcess y actionRedsysAfterIPNProcess — consulta la referencia de hooks para insertar tu propia lógica.

Servicios y capacidades

La lógica de negocio reside en clases de servicio PSR-4 bajo src/Service/ (namespace RedsysGateway\Service\). Son bloques de construcción internos que puedes reutilizar desde un override o un módulo complementario; no son endpoints de red.

Las capacidades de pago se registran a través de un pequeño registro bajo src/Capability/ (CapabilityRegistry con PreauthCapability, RefundCapability y TokenRCapability). Los terceros pueden registrar y consultar capacidades mediante los hooks actionRegisterPaymentCapabilities y actionCheckPaymentCapability.

Controladores de administración

Las pestañas del back-office se encuentran bajo controllers/admin/. Se renderizan dentro de la administración de PrestaShop y están protegidas por los permisos habituales de empleado.

Configuración

Todos los ajustes se almacenan a través del almacén Configuration de PrestaShop y se editan desde la pantalla de configuración del módulo (Módulos → Redsys para PrestaShop → Configurar). Lee los valores en código con la API estándar de PrestaShop:

// Read a stored Redsys configuration value (key names are internal to the module).
$merchantCode = Configuration::get('REDSYS_MERCHANT_CODE'); // example key
$terminal     = Configuration::get('REDSYS_TERMINAL');      // example key

El hook actionRedsysConfigSave se dispara cada vez que se guarda la configuración, de modo que un módulo complementario puede reaccionar a cambios de credenciales o de terminal.

Extender el módulo

Como no hay API remota, la personalización se realiza mediante los hooks que despacha el módulo. El módulo dispara 18 hooks a lo largo del ciclo de vida del pago, tokens, gestión de IPN, express checkout, Paygold y capacidades de pago — por ejemplo actionRedsysBeforePayment, actionRedsysPaymentSuccess, actionRedsysPaymentError, actionRedsysModifyParameters (encadenable) y actionRedsysTokenCreated.

Consulta la lista completa con parámetros, valores de retorno y ejemplos de código en la referencia de hooks de Redsys para PrestaShop.