133 lines
4.9 KiB
ReStructuredText
133 lines
4.9 KiB
ReStructuredText
===========================================
|
|
Pasarela de pago Redsys con preautorización
|
|
===========================================
|
|
|
|
..
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!! This file is generated by oca-gen-addon-readme !!
|
|
!! changes will be overwritten. !!
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!! source digest: sha256:1eb9535d052a619aa545a383869076ca1dc1fade22746cb3fe13afa726c3e3a3
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
|
|
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
|
|
:target: https://odoo-community.org/page/development-status
|
|
:alt: Beta
|
|
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
|
|
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
|
|
:alt: License: AGPL-3
|
|
.. |badge3| image:: https://img.shields.io/badge/github-Criptomart%2Ffoodcoopbcn-lightgray.png?logo=github
|
|
:target: https://github.com/Criptomart/foodcoopbcn/tree/12.0/payment_redsys_preauth
|
|
:alt: Criptomart/foodcoopbcn
|
|
|
|
|badge1| |badge2| |badge3|
|
|
|
|
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**
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
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 <https://github.com/Criptomart/foodcoopbcn/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 <https://github.com/Criptomart/foodcoopbcn/issues/new?body=module:%20payment_redsys_preauth%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
|
|
|
|
Do not contact contributors directly about support or help with technical issues.
|
|
|
|
Credits
|
|
=======
|
|
|
|
Authors
|
|
~~~~~~~
|
|
|
|
* Criptomart
|
|
|
|
Contributors
|
|
~~~~~~~~~~~~
|
|
|
|
* `Criptomart <https://www.criptomart.net>`_:
|
|
|
|
* Santi Noreña
|
|
|
|
Maintainers
|
|
~~~~~~~~~~~
|
|
|
|
This module is part of the `Criptomart/foodcoopbcn <https://github.com/Criptomart/foodcoopbcn/tree/12.0/payment_redsys_preauth>`_ project on GitHub.
|
|
|
|
You are welcome to contribute.
|