Pago con tarjeta mediante Stripe Terminal¶

Un lector de tarjetas Stripe acepta tarjetas, móviles y relojes inteligentes sin contacto o con chip; DiKAS lo controla a través de la nube de Stripe. La caja envía el importe a Stripe y Stripe lo muestra en el lector. No hace falta un agente de hardware ni abrir nada en el router del local: el lector solo necesita internet. Esta página muestra para qué sirve, cómo se configura el lector y qué ocurre en la caja.

De un vistazo¶


Tipo de terminal en DiKAS	Stripe Terminal
Cómo se realiza el pago	Caja → nube de Stripe → lector (sin pasar por la red del local)
Recibo de la tarjeta	El lector no tiene impresora: DiKAS imprime el recibo de la tarjeta en el ticket de caja
Propina en el lector	no se comunica a la caja
Abono a tarjeta	solo con referencia al pago original (anulación del recibo)
Cierre de caja en el lector	no existe: los pagos a la cuenta se realizan automáticamente a través de Stripe

Dispositivos y países compatibles¶

Qué	Estado
Lectores de tarjetas Stripe configurados como lector en su cuenta de Stripe y con un ID de lector (empieza por `tmr_`)	✅ compatible
Qué modelos de lector habilita Stripe para el control desde la nube	lo decide Stripe: compruebe el modelo y la disponibilidad en su cuenta de Stripe
Terminales de tarjeta de otros proveedores	véase su propia guía, p. ej. terminal ZVT

Moneda: el cobro se realiza en la moneda principal de su negocio (p. ej. euro o franco suizo). En qué países ofrece Stripe lectores de tarjetas y qué tarjetas se aceptan lo determina su cuenta de Stripe, no DiKAS.

Requisitos previos¶

Una cuenta de Stripe en la que el lector de tarjetas esté configurado como lector y en línea.
El ID de lector (tmr_…): figura en su cuenta de Stripe, en el área Terminal.
La clave secreta (Secret Key, empieza por sk_live_ o sk_test_) de su cuenta de Stripe: se encuentra en las claves de API de su cuenta de Stripe. El formulario acepta también claves que empiezan por rk_.
Acceso a internet en el lector y en el servidor DiKAS o la caja en la nube.
Un usuario con acceso a Admin → Configuración.

Primero en modo de prueba

Con una clave que empiece por sk_test_, Stripe trabaja en modo de prueba: no se carga ninguna tarjeta real. Para el uso real, introduzca después la clave sk_live_.

Configuración en 8 pasos¶

Abrir las opciones de pago: Admin → Configuración → Hardware → Opciones de pago.
Hacer clic en Añadir terminal (icono más) y asignar un nombre, p. ej. «Lector barra».
En Tipo elegir Stripe Terminal. Aparece el campo del ID de lector (marcador tmr_xxx).
Introducir el ID de lector.
Debajo de la lista de terminales aparece la pestaña Stripe. Introduzca allí la Secret Key. DiKAS la guarda cifrada y no vuelve a mostrarla en texto claro; una clave guardada aparece como «•••• guardada (dejar vacío para conservar)».
Hacer clic arriba en Guardar. Sin guardar, el servidor aún no conoce el nuevo lector.
En la pestaña Stripe hacer clic en Probar conexión. Si aparece Conexión correcta, la clave es válida. En caso de error, DiKAS muestra el texto de Stripe.
En la fila del lector hacer clic en el icono Comprobar estado (símbolo Wi-Fi). Un punto verde significa que el lector está en línea en Stripe. Si no, el tooltip muestra p. ej. Reader-Status: offline.

Después, realice un pago de prueba con un importe pequeño (véase más abajo) y anúlelo.

Otros campos de la pestaña Stripe

La Publishable Key no es necesaria para el pago con tarjeta en el lector; afecta a otras funciones de Stripe que usan la misma pestaña (p. ej. pedidos en línea o pago por código QR). DiKAS no evalúa la Location-ID en los pagos en el lector. Los datos de acceso valen en común para todas las funciones de Stripe del negocio.

Varios lectores y varias cajas¶

Una entrada de terminal por lector, con nombre propio e ID de lector propio.
Qué lector se usa en qué caja se define con el Terminal predeterminado (selección bajo la lista de terminales) o por puesto de trabajo o dispositivo; véase Hardware: terminales de tarjeta.
El diálogo de pago muestra siempre el nombre del lector, de modo que un dispositivo equivocado se nota enseguida.

Cómo funciona el pago en la caja¶

Registrar los artículos y elegir Cobrar, después Tarjeta EC o Tarjeta de crédito.
Se abre el diálogo Pago con tarjeta con el importe y el nombre del lector (Terminal: …).
El importe aparece en el lector. El cliente acerca tarjeta, móvil o reloj al lector o introduce la tarjeta.
Cuando Stripe comunica el pago como completado, DiKAS muestra Pago realizado con éxito y contabiliza el recibo.

Si el pago queda sin confirmar¶

Si Stripe aún no ha comunicado la finalización cuando DiKAS pregunta, DiKAS muestra Pago sin confirmar con el aviso NO vuelvas a cobrar — comprueba el pago en el terminal. y el botón Cerrar.

No repetir a ciegas

Compruebe primero en el lector y en su cuenta de Stripe (área Pagos) si se cargó la tarjeta. Después inicie el pago de nuevo en el mismo lector: DiKAS concilia primero la operación abierta con Stripe en lugar de provocar un segundo cargo. Si tuvo éxito y el importe coincide, se acepta. Si el importe difiere, DiKAS comunica un caso por aclarar hasta que lo resuelva. Si el servidor DiKAS se reinició entretanto, la operación abierta ya no consta allí: entonces vale solo la comprobación en su cuenta de Stripe.

Propina¶

El lector no comunica ninguna propina a la caja. Registre la propina en la caja como en cualquier otro pago.

Recibo de la tarjeta: ¿quién imprime?¶

Un lector Stripe no tiene impresora propia. Al crear el tipo, DiKAS pone El terminal tiene impresora propia automáticamente en desactivado: el recibo de la tarjeta se imprime en el ticket de caja, sin impresión doble.

Anulación y abono a tarjeta¶

Caso	Cómo funciona
Anular un recibo	La anulación se realiza con referencia al pago original: DiKAS devuelve el importe completo del pago a la tarjeta a través de Stripe y crea después el recibo de anulación. Solo se puede anular en la caja a la que está asignado el lector del pago y se necesita el derecho Realizar abono con tarjeta (los administradores siempre).
Abono libre a tarjeta (sin pago original)	No es posible. Stripe solo devuelve sobre un pago existente. DiKAS indica: Stripe Terminal unterstützt keine referenzlose Karten-Gutschrift … Bitte mit Bezug auf den Ursprungsbeleg stornieren (funktioniert) oder bar erstatten. (Stripe Terminal no admite un abono a tarjeta sin referencia; anule sobre el recibo original, lo cual funciona, o devuelva en efectivo.)

Cierre de caja y cierre diario¶

Stripe no tiene un cierre de caja como los terminales de tarjeta clásicos. DiKAS muestra el aviso Stripe Terminal kennt keinen Kassenschnitt — Auszahlungen laufen automatisch über Stripe (Dashboard → Auszahlungen). (Stripe Terminal no tiene cierre de caja: los pagos a su cuenta se realizan automáticamente a través de Stripe, Dashboard → Pagos) cuando hace clic en las opciones de pago en el icono de cierre del lector. En el menú de la caja (Menú → Terminal de tarjeta → Cierre), DiKAS indica en un lector Stripe únicamente Cierre de caja correcto, sin que se cierre nada en el lector. Concilie las ventas con tarjeta en su cuenta de Stripe si lo necesita. El lector no ofrece subtotal de ventas.

Límites¶

Sin propina en el lector, sin abono libre a tarjeta, sin cierre de caja.
Internet es obligatorio: sin conexión con Stripe no es posible pagar con tarjeta en el lector.
Un lector pertenece a una cuenta de Stripe: la clave secreta vale en común para todos los lectores Stripe del negocio.

Errores y soluciones¶

Mensaje / Qué ve	Causa y solución
Stripe Terminal ist nicht konfiguriert (Secret Key oder Reader-ID fehlt) (no configurado: falta la clave secreta o el ID de lector)	Introducir la Secret Key en la pestaña Stripe y el ID de lector en el terminal, y Guardar.
Stripe-Terminal … nicht gefunden (no encontrado)	El lector aún no está guardado o se eliminó. Crear el terminal o Guardar.
Reader-Status: offline (u otro estado distinto de «online»)	Encender el lector y comprobar su conexión a internet; debe aparecer en línea en su cuenta de Stripe. Después Comprobar estado.
Fallo de conexión o texto de error de Stripe en Probar conexión	Comprobar la clave secreta (formato `sk_…`) y volver a introducirla. El formulario muestra Formato esperado: sk_… si el formato es incorrecto.
Zahlung unbestätigt — wird geprüft. Bitte NICHT erneut versuchen, sondern kurz warten. (pago sin confirmar, NO reintentar, esperar un momento)	Véase Si el pago queda sin confirmar.
Stripe-Terminal-Status nach Reader-Push unsicher. (estado incierto tras enviar al lector)	La conexión con Stripe se interrumpió tras el envío; el pago puede haber llegado al lector. Tratar como «sin confirmar»: comprobar en la cuenta de Stripe y no cobrar de nuevo enseguida.
Unbestätigte frühere Zahlung über einen abweichenden Betrag gefunden — bitte klären (pago anterior sin confirmar por otro importe)	Hay una operación abierta con otro importe. Aclararla en la cuenta de Stripe (devolver si es necesario) y solo entonces volver a cobrar.
Zahlung abgebrochen. / Zahlung abgelehnt oder abgebrochen. (cancelado / rechazado o cancelado)	El cliente o el personal canceló en el lector, o la tarjeta fue rechazada. Probar otra tarjeta u otra forma de pago.
Stripe Terminal unterstützt keine referenzlose Karten-Gutschrift …	Con Stripe no es posible un abono libre. Anular el recibo o devolver en efectivo.
Keine Transaktionsreferenz für das Storno vorhanden. (sin referencia de transacción para la anulación)	Al recibo le falta la referencia de Stripe. Una devolución a través de DiKAS no es posible; contacte con el soporte.
Diese Kartenzahlung lief über … Stornieren ist nur an der Kasse mit diesem Terminal möglich. (anular solo en la caja con este terminal)	Realizar la anulación en la caja a la que está asignado este lector.
Keine Berechtigung für Karten-Erstattungen. (sin permiso para devoluciones a tarjeta)	Dar al usuario el derecho Realizar abono con tarjeta en Admin → Personal o hacer que anule un administrador.

Siguiente paso¶

→ Formas de pago y pago con tarjeta en la caja: anulación, abono y tipo de tarjeta como forma de pago → Hardware: terminales de tarjeta: resumen de todos los tipos de terminal