Search 1.9 billion lines of Odoo code on GitHub
payment_redsys
<h1 class="title">Pasarela de pago Redsys</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/l10n-spain/tree/13.0/payment_redsys"><img alt="OCA/l10n-spain" src="https://img.shields.io/badge/github-OCA%2Fl10n--spain-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/l10n-spain-13-0/l10n-spain-13-0-payment_redsys"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/189/13.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>Este módulo añade la opción de pago a través de la pasarela de Redsys pudiendo
seleccionar entre los métodos de pago: pago con tarjeta, pago por transferencia,
domiciliación y Bizum.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#installation" id="id1">Installation</a></li>
<li><a class="reference internal" href="#configuration" id="id2">Configuration</a><ul>
<li><a class="reference internal" href="#parametros" id="id3">Parámetros</a></li>
<li><a class="reference internal" href="#nota" id="id4">Nota</a></li>
</ul>
</li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id5">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id6">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id7">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id8">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id9">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id10">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="installation"></a>
<h2><a class="toc-backref" href="#id1">Installation</a></h2>
<p>Para utilizar este módulo, necesita la biblioteca <a class="reference external" href="https://pypi.python.org/pypi/pycryptodome">pycryptodome</a> instalada en su sistema:</p>
<pre>
<code>pip3 install pycryptodome</code>
</pre>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id2">Configuration</a></h2>
<a name="parametros"></a>
<h3><a class="toc-backref" href="#id3">Parámetros</a></h3>
<ul class="simple">
<li><strong>Nombre del comercio</strong>: Indicaremos el nombre del comercio.</li>
<li><strong>Número de comercio (FUC)</strong>: Indicaremos el número de comercio que
nuestra entidad nos ha comunicado.</li>
<li><strong>Clave secreta de encriptación</strong>: Indicaremos la clave de encriptación
que tiene el comercio.</li>
<li><strong>Número de terminal</strong>: Indicaremos el terminal del TPV.</li>
<li><strong>Tipo de firma</strong>: Seleccionaremos el tipo de firma del comercio.</li>
<li><strong>Tipo de moneda</strong>: Seleccionaremos la moneda de nuestro terminal TPV
(Normalmente EUR - Euros).</li>
<li><strong>Tipo de transacción</strong>: Indicaremos el tipo de transacción, 0.</li>
<li><strong>Idioma TPV</strong>: Indicaremos el idioma en el TPV.</li>
<li><strong>Método de pago</strong>: Indicaremos que tipo de pago se debe aceptar, pago con
tarjeta, Bizum u otro de los disponibles.</li>
<li><strong>URL_OK/URL_KO</strong>: 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.</li>
<li><strong>Porcentaje de pago</strong>: Indicar el porcentaje de pago que se permite, si
se deja a 0.0 se entiende 100%.</li>
</ul>
<a name="nota"></a>
<h3><a class="toc-backref" href="#id4">Nota</a></h3>
<p>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”.</p>
<p>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 <strong>dbfilter</strong> y <strong>dbname</strong> en el archivo de configuración.</p>
<p>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.</p>
<p>En el caso de Bizum, el titular del TPV deberá solicitar al banco su activación.</p>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id5">Known issues / Roadmap</a></h2>
<p>De acuerdo a los requisitos de Redsys, el tamaño máximo del número de pedido
resultante (<code>Ds_Order</code>) 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.</p>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id6">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/l10n-spain/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/l10n-spain/issues/new?body=module:%20payment_redsys%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id7">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id8">Authors</a></h3>
<ul class="simple">
<li>Tecnativa</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id9">Contributors</a></h3>
<ul class="simple">
<li><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a>:<ul>
<li>Sergio Teruel</li>
<li>Carlos Dauden</li>
<li>Carlos Roca</li>
</ul>
</li>
<li>Isaac Gallart <<a class="reference external" href="mailto:igallart@puntsistemes.es">igallart@puntsistemes.es</a>></li>
<li><a class="reference external" href="https://www.acysos.com">Acysos S.L.</a>:<ul>
<li>Ignacio Ibeas <<a class="reference external" href="mailto:ignacio@acysos.com">ignacio@acysos.com</a>></li>
</ul>
</li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id10">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.</p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/l10n-spain/tree/13.0/payment_redsys">OCA/l10n-spain</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>