Guía del usuario

1.1. Guía del usuario#

1.1.1. Introducción#

1.1.1.1. Acerca de GNU Taler#

1.1.1.2. Acerca de esta guía#

Esta guía explica varias formas en las que los usuarios pueden interactuar con una instalación de GNU Taler. Asume que un banco, una bolsa y un comerciante están funcionando y que el usuario tiene un monedero GNU Taler instalado y es capaz de crear una cuenta en el banco. Algunas operaciones también requieren acceso al backend del comerciante.

1.1.2. Retirada de fondos de cuentas bancarias#

La retirada es el paso en el que el dinero se mueve de una cuenta bancaria a un monedero GNU Taler. Hay dos formas principales de hacerlo.

1.1.2.1. Retirada bancaria integrada#

Si el banco lo admite, puedes retirar dinero a tu monedero de GNU Taler directamente desde tu aplicación bancaria o sitio web de banca online. Si es compatible, debería haber una opción en tu banca online para retirar dinero a un monedero de GNU Taler. El banco le pedirá la cantidad y generará un código QR que deberá escanear con su monedero GNU Taler. Alternativamente, si el monedero WebExtension está instalado, la página web del banco puede cambiar directamente al monedero GNU Taler. En el monedero GNU Taler, es posible que primero tenga que confirmar los términos de servicio del intercambio GNU Taler seleccionado. Después, se mostrarán las tarifas aplicables y se le dará la opción de aceptar la retirada. A continuación, deberá autorizar la operación de retirada en el banco. Si es posible, el monedero GNU Taler puede cambiar automáticamente a la página web del banco, también es posible que tenga que volver a la aplicación bancaria explícitamente. Después de autorizar la operación de retirada, tendrá que esperar un poco para que el dinero sea transferido a la casa de cambio. Dependiendo del sistema bancario, esto puede tardar desde unos segundos hasta muchas horas. Después, el dinero aparecerá en tu monedero.

1.1.2.2. Retirada iniciada por el monedero#

En este caso, iniciará el proceso de retirada desde el monedero GNU Taler. En «Configuración», encontrará una lista de bolsas. Si la lista está vacía o no contiene el intercambio deseado, puede que tenga que añadir primero el intercambio proporcionando la URL respectiva. El proveedor de servicios de pago que opera el servicio de intercambio debería tener dicho código QR en su sitio web.

Junto al cambio, hay un menú desplegable con una opción para «retirar». (Si ya tienes dinero en tu monedero, también encontrarás el mismo botón al consultar el historial de transacciones de la moneda correspondiente). El monedero te pedirá que introduzcas la cantidad a retirar y que aceptes las condiciones del servicio y pagues las comisiones aplicables (si las hubiera). Después, el monedero le dará instrucciones para realizar la transferencia, indicándole qué cantidad debe transferir a qué cuenta bancaria. Y lo que es más importante, el monedero le dará un asunto de transferencia que deberá especificar para la transferencia. Si comete un error tipográfico en el asunto, el monedero no se recargará y la casa de cambio le devolverá el dinero a su cuenta bancaria (posiblemente descontando una comisión). Sólo tienes que hacer la transferencia siguiendo las instrucciones del monedero. Una vez que el dinero haya llegado a la casa de cambio, el monedero retirará automáticamente los fondos.

1.1.3. Ingreso en cuenta bancaria#

Si tiene dinero en su monedero, puede utilizar el botón «depositar» para ingresar los fondos en una cuenta bancaria. El monedero te pedirá que especifiques la cantidad y la cuenta bancaria de destino.

1.1.4. Envío de dinero digital#

Una vez que tengas dinero digital, puedes enviarlo a otro monedero GNU Taler. Simplemente especifica la cantidad y una razón legible para la transferencia. El monedero mostrará entonces un código QR (y dará la opción de exportar el pago como taler://-URL). Envíe la imagen del código QR al monedero receptor (o envíe el taler://-URL de forma segura al monedero de destino).

El monedero de destino debe escanear el código QR (o introducir el texto de la taler://-URL en el cuadro de diálogo de importación de URL que está disponible manteniendo pulsado o haciendo clic en el botón de escaneo del código QR). Después, revise el texto del motivo y acepte los fondos para completar la transacción.

1.1.5. Recibir dinero digital#

Para recibir fondos de otro usuario, puede enviar una solicitud de pago a otro monedero GNU Taler. Simplemente especifique la cantidad y una razón legible para la solicitud de pago. El monedero mostrará entonces un código QR (y dará la opción de exportar la solicitud de pago como taler://-URL). Envíe la imagen del código QR al monedero pagador (o envíe el taler://-URL al monedero de destino).

El monedero de destino debe escanear el código QR (o introducir el texto de la taler://-URL en el cuadro de diálogo de importación de URL que está disponible manteniendo pulsado o haciendo clic en el botón de escaneo del código QR). A continuación, revise el motivo de la solicitud de pago y decida si desea pagarla o no. Al seleccionar «pagar» se completará la transacción.

Dependiendo de la configuración del intercambio, el monedero receptor puede tener que someterse a alguna comprobación KYC antes de que los fondos sean realmente liberados al receptor.

1.1.6. Configuración de cuentas en una instancia de vendedor#

Antes de que pueda configurar una instancia de comerciante, necesita que alguien opere un Taler Merchant Backend y le conceda acceso a una instancia en ese backend. Para ello, debe recibir la URL base de la instancia y un token de acceso.

El principal dato de configuración que debe facilitarse para cada instancia es la información de la cuenta bancaria.

Para recibir los pagos, el backend del comerciante debe comunicar los datos de la cuenta bancaria a la bolsa.

La información de la cuenta bancaria se proporciona en forma de payto://-URI. Véase RFC 8905 para el formato de payto://-URIs. Tenga en cuenta que el «nombre-del-receptor» es opcional en RFC 8905 pero obligatorio en GNU Taler.

For first tests, you may want to sign up for a KUDOS bank account at https://bank.demo.taler.net/. In this case, the payto://-URI will be of the form payto://iban/$IBAN?receiver-name=$NAME where $IBAN must be replaced with the IBAN shown on the main page of the account shown at https://bank.demo.taler.net/ after logging in.

Al implementar Taler con el sistema bancario real, lo primero que tiene que hacer es cambiar la divisa de la configuración de KUDOS a la divisa real (como EUR, USD, CHF) y proporcionar un payto://-URI de su cuenta bancaria real. En Europa, esto implicará conocer su número IBAN. Si tiene un IBAN, el correspondiente payto://-URI es simplemente payto://iban/$IBAN?receiver-name=$NAME donde $IBAN debe sustituirse por el número IBAN real y $NAME por su nombre real. Asegúrese de codificar su nombre en URI. El SPA comercial lo hará automáticamente cuando lo utilice para configurar la cuenta bancaria.

1.1.7. Uso de la aplicación de punto de venta#

Una forma sencilla para que los comerciantes acepten pagos con GNU Taler es el uso de la aplicación de punto de venta. La aplicación puede instalarse en un teléfono o tableta Android y se configura mediante un sencillo archivo JSON en un sitio web:

  • En la configuración de la aplicación, debe especificar la URL del sitio web desde el que la aplicación puede descargar las categorías, los productos y los precios a partir de los cuales deben compilarse los pedidos. Opcionalmente, puede especificar un nombre de usuario y una contraseña para autenticarse en el servidor web.

  • La sintaxis del archivo JSON se describe en el manual de la aplicación de punto de venta. Sin embargo, puede que simplemente desee descargar el archivo JSON de ejemplo de nuestra documentación y utilizarlo como punto de partida.

  • Una opción clave es el backend de comerciante con la clave de autorización que debe incluirse en esta configuración JSON. Puede apuntar la aplicación de punto de venta a cualquier instancia de un backend de comerciante.

Una vez configurada, la aplicación de punto de venta permite al usuario seleccionar una categoría de productos y, a continuación, añadir rápidamente productos de esa categoría a un pedido. Se puede editar fácilmente el pedido y, por último, utilizar el botón «completar» para generar un código QR. A continuación, el código QR debe ser escaneado por el monedero GNU Taler para iniciar el pago. Se pueden introducir varios pedidos simultáneamente, por ejemplo en un restaurante donde se atienden varias mesas al mismo tiempo.