# Pasarela de pago Redsys con preautorización

Este módulo añade la opción de pago a través de la pasarela de Redsys con preautorización con tarjeta bancaria.

Table of contents

- Configuration
  - Parámetros
  - Nota
- Known issues / Roadmap
- Bug Tracker
- Credits
  - Authors
  - Contributors
  - Maintainers

# Configuration

## Parámetros

- Nombre del comercio: Indicaremos el nombre del comercio.
- Número de comercio (FUC): Indicaremos el número de comercio que nuestra entidad nos ha comunicado.
- Clave secreta de encriptación: Indicaremos la clave de encriptación que tiene el comercio.
- Número de terminal: Indicaremos el terminal del TPV.
- Tipo de firma: Seleccionaremos el tipo de firma del comercio.
- Tipo de moneda: Seleccionaremos la moneda de nuestro terminal TPV (Normalmente EUR - Euros).
- Tipo de transacción: Indicaremos el tipo de transacción, 1.
- Idioma TPV: Indicaremos el idioma en el TPV.
- Método de pago: Indicaremos que tipo de pago se debe aceptar, pago con tarjeta, Bizum u otro de los disponibles.
- URL_OK/URL_KO: Durante el proceso del pago, y una vez que se muestra al cliente la pantalla con el resultado del mismo, es posible redirigir su navegador a una URL para las transacciones autorizadas y a otra si la transacción ha sido denegada. A éstas se las denomina URL_OK y URL_KO, respectivamente. Se trata de dos URLs que pueden ser proporcionadas por el comercio.
- Porcentaje de pago: Indicar el porcentaje de pago que se permite, si se deja a 0.0 se entiende 100%.

## Nota

Se tiene que verificar la configuración del comercio en el módulo de administración de Redsys, donde la opción “Parámetros en las URLs” debe tener el valor “SI”.

En caso de que exista más de una base de datos en la instalación, cuando la pasarela de pago envía el formulario a “/payment/redsys/return” odoo no sabe con que base de datos procesar esta información, por lo que hay que establecer los parametros dbfilter y dbname en el archivo de configuración.

Para mostrar simultáneamente en el comercio electrónico varios de los métodos de pago que proporciona Redsys, como pago con tarjeta y Bizum por ejemplo, debemos duplicar el medio de pago y escoger en el campo método de pago el que corresponda en cada caso.

En los pagos con preautorización, el titular del TPV deberá solicitar al banco su activación.

# Known issues / Roadmap

De acuerdo a los requisitos de Redsys, el tamaño máximo del número de pedido resultante (`Ds_Order`) es de 12 caracteres. Este addon trunca dicho dato en el comienzo de la transacción, con el resultado de que, aunque Redsys la aceptará, no se finalizará el pedido pedido en Odoo al retornar y entregará un Error 500 a Redsys. Para evitar esto, es recomendable seleccionar secuencias de pedido que se ajusten a esta limitación, en particular de 10 o menos caracteres, al ser la referencia un número extendido a partir del pedido, que incluye un guion y un número secuencial para posibles repeticiones de pago.

# Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

# Credits

## Authors

- Criptomart

## Contributors

- Criptomart:
  - Santi Noreña

## Maintainers

This module is part of the Criptomart/foodcoopbcn project on GitHub.

You are welcome to contribute.