Metadata-Version: 2.1
Name: odoo-addon-payment_redsys
Version: 17.0.1.0.3
Requires-Python: >=3.10
Requires-Dist: odoo>=17.0a,<17.1dev
Requires-Dist: pycryptodome
Summary: Payment Acquirer: Redsys Implementation
Home-page: https://github.com/OCA/l10n-spain
License: AGPL-3
Author: Tecnativa, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 17.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=======================
Pasarela de pago Redsys
=======================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:84cbed2cdb4d197c41a0cd7907ee4852dc4168bc413a3d5b1bcdfecc42eaca4c
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/license-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-OCA%2Fl10n--spain-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-spain/tree/17.0/payment_redsys
    :alt: OCA/l10n-spain
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-spain-17-0/l10n-spain-17-0-payment_redsys
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-spain&target_branch=17.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

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.

**Table of contents**

.. contents::
   :local:

Installation
============

Para utilizar este módulo, necesita la biblioteca
`pycryptodome <https://pypi.python.org/pypi/pycryptodome>`__ instalada
en su sistema:

::

   pip3 install pycryptodome

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, 0.
- **Idioma TPV**: Indicaremos el idioma en el TPV.
- **Método de pago**: Indicaremos qué tipo de pago se debe aceptar, pago
  con tarjeta, Bizum u otro de los disponibles.
- **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 el caso de Bizum, 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/OCA/l10n-spain/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/OCA/l10n-spain/issues/new?body=module:%20payment_redsys%0Aversion:%2017.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
-------

* Tecnativa

Contributors
------------

- `Tecnativa <https://www.tecnativa.com>`__:

  - Sergio Teruel
  - Carlos Dauden
  - Carlos Roca
  - João Marques

- Isaac Gallart <igallart@puntsistemes.es>
- `Acysos S.L. <https://www.acysos.com>`__:

  - Ignacio Ibeas <ignacio@acysos.com>

- `Planes Asesoria y Soluciones Informaticas
  S.L. <https://www.planesnet.com>`__:

  - Luis Planes <luis@planesnet.com>

- `Studio73 <https://www.studio73.es/>`__:

  - Rafa Ferri <rafa.ferri@studio73.es>

- `Factor Libre <https://factorlibre.com/>`__:

  - Pablo De Andrés <pablo.deandres@factorlibre.com>

- `APSL-Nagarro <https://apsl.tech>`__:

  - Antoni Marroig <amarroig@apsl.net>

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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.

This module is part of the `OCA/l10n-spain <https://github.com/OCA/l10n-spain/tree/17.0/payment_redsys>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
