Caja – Guía para comercios

Con la caja de KAI-Pay aceptas pagos en bitcoin por Lightning, por ejemplo en el mostrador o en un puesto de mercado. La caja es una página aparte (kasse.kai-pay.net) sin claves: solo puede crear facturas, pero no enviar dinero. Cada pago va directamente a tu billetera KAI-Pay autocustodiada. Allí ves el cierre diario y mensual y puedes hacer reembolsos.

KAI-Pay es una beta pública. La caja funciona como terminal de pago, no es una caja registradora (consulta Límites).

1. Requisitos

• Una billetera KAI-Pay cuyas 12 palabras hayas respaldado y confirmado en la app.
• Una dirección Lightning: créala en la billetera, en “Recibir”.
• Internet en el dispositivo de caja. No se necesita cuenta ni registro.

2. Configurar la caja

1. En la billetera, abre el menú y elige “Caja y cierre”. Al final de todo está “Configurar caja”.
2. Si quieres, ingresa un nombre de la caja, por ejemplo “Mostrador 1” o “Mercado”. Con el nombre cambian el enlace y el código QR.
3. Abre la caja:
   • En el mismo dispositivo: “Abrir la caja en este dispositivo”. La caja se abre en una pestaña nueva o, en la app de Android, en el navegador.
   • En un dispositivo de caja propio (p. ej., una tablet en el mostrador): escanea el código QR con ese dispositivo, o copia o comparte el enlace y ábrelo allí.

El enlace contiene tu dirección Lightning, el nombre de la caja y una clave pública de comprobantes. Estos datos están en la parte del enlace que va después de “#”; no se transmiten a ningún servidor. La caja los guarda en el dispositivo de caja. La próxima vez que abras kasse.kai-pay.net, se inicia directamente; ya no necesitas el enlace.

Si alguien abre en un dispositivo de caja ya configurado un enlace con otra dirección u otra clave de comprobantes, la caja pregunta antes de cambiar. Confirma solo si lo configuraste tú. La caja y la billetera muestran la huella de la clave de comprobantes; puedes compararlas.

3. Cobrar

1. Escribe el monto: en una moneda local (EUR, USD, GBP, CHF, CAD, AUD o JPY, convertida con el tipo de cambio de mempool.space que se muestra junto con su hora de actualización) o en sat (“Ingresar en sat”). El tipo de cambio queda fijado para la factura. En moneda local, la caja solo cobra con un tipo de cambio obtenido hace como máximo 5 minutos y que, según mempool.space, no tenga más de 30 minutos de antigüedad.
2. “Cobrar”: la caja muestra una factura como código QR.
3. Quien compra la escanea con cualquier billetera Lightning y paga.
4. La caja muestra “Pagado” y un comprobante de pago numerado. Es una constancia de pago, no un ticket de caja. “Comprobante en PDF” lo guarda como archivo.

Avisos de la caja:

• Cancelar: una factura cancelada aún se puede pagar. Si el pago llega más tarde, la caja lo avisa expresamente.
• Página recargada: “Factura abierta retomada” – la caja sigue verificando la factura en curso. No cobres dos veces.
• “Factura expirada – no pagada”: vuelve a cobrar.
• “Estado del pago desconocido” (sin conexión): antes de volver a cobrar, revisa el ingreso en la billetera.
• “Últimas facturas” muestra las últimas facturas de este dispositivo (máximo 20 de los últimos 7 días). Lo que vale siempre es el historial de la billetera.

Cobrar con artículos

1. “Administrar artículos”: nombre, precio y moneda del precio (moneda local o sat) y, de forma opcional, categoría y tasa de impuesto. La tasa de impuesto es solo un dato en el comprobante; KAI-Pay no calcula impuestos.
2. “Artículos”: toca los artículos y cambia la cantidad con − y +. Un carrito tiene exactamente una moneda.
3. “Cobrar”: la suma se convierte en la factura. Las líneas, los precios y el tipo de cambio quedan fijados para este pedido – los cambios de precio posteriores no modifican los comprobantes pagados.

Los artículos solo se guardan en el dispositivo de caja. “Exportar catálogo” los guarda como archivo; en otra caja o en la billetera (Caja y cierre → Artículos) los incorporas con “Importar catálogo”. La billetera solo necesita el catálogo para mostrar las líneas con su nombre; una nueva importación no cambia los nombres de los artículos ya importados. Cambiar el nombre crea en la caja un artículo nuevo, para que los comprobantes antiguos conserven su nombre.

Las líneas y los montos en monedas distintas del euro solo llegan a la billetera si la caja se configuró con el enlace de caja actual de tu billetera. Para cajas configuradas con un enlace anterior: vuelve a abrir una vez el enlace de caja desde la billetera. Hasta entonces, las líneas solo figuran en el comprobante de la caja.

Comprobante en PDF

La caja y la billetera generan el comprobante en PDF en el dispositivo a partir de los datos guardados, sin servidor; si lo vuelves a generar, el mismo pago da el mismo archivo (mismo idioma y zona horaria). La caja solo tiene disponibles los comprobantes de sus últimas facturas (máximo 20 de los últimos 7 días). Es una constancia de pago, no una factura en el sentido del § 14 UStG (Alemania) ni un ticket de caja. Para los reembolsos, la billetera crea un comprobante de reembolso aparte.

4. Nombre de la caja y varias cajas

La billetera no guarda el nombre de la caja. Este viaja así:

1. El nombre está en el enlace. La caja lo guarda en el dispositivo de caja, junto con un identificador aleatorio del dispositivo y un contador correlativo de comprobantes.
2. Con cada pago, la caja envía una nota cifrada: identificador del dispositivo, nombre de la caja, número de comprobante, monto en moneda local y tipo de cambio y, con artículos, también las líneas. Solo tu billetera puede leerla.
3. La billetera lee estas notas de los pagos y, en el cierre, las asigna a cada caja.

• Cambiar el nombre: abre el enlace con el nombre nuevo en el mismo dispositivo de caja. El identificador del dispositivo y los números de comprobante continúan; los pagos anteriores conservan el nombre que tenían entonces.
• Sin nombre: la caja conserva su nombre anterior o se llama “Caja”.
• Varias cajas: configura cada dispositivo con su propio nombre. Dos dispositivos con el mismo nombre aparecen en el cierre como filas separadas, y la billetera te lo indica.

5. Cierre diario

En la billetera, en “Caja y cierre”, elige un día. Para cada caja ves:

• el número de pagos y la suma en sat,
• el monto según la caja por moneda local (al tipo de cambio fijado para la factura),
• el rango de números de comprobante, así como los números faltantes o duplicados,
• los reembolsos y el monto neto.

Además, la billetera indica “Otros ingresos” (pagos a tu dirección que no llegaron por la caja) y los pagos aún pendientes.

6. Cierre mensual y exportación CSV

“Exportar día como CSV” o “Exportar mes como CSV” guarda un archivo con una fila por transacción:

• fecha, hora, caja y número de comprobante,
• monto en sat y comisión,
• monto según la caja con moneda y tipo de cambio,
• ID de pago y tipo (venta o reembolso; los reembolsos, con signo menos).

Al final figuran las sumas en sat y por moneda local.

Para ello, la billetera no lleva un libro de caja propio. Calcula el cierre cada vez a partir del historial de pagos. Por eso puedes volver a exportar cualquier mes anterior, mientras los pagos figuren en el historial. La billetera deriva la clave de las notas de comprobante de tus 12 palabras; también después de una restauración, las notas siguen siendo legibles.

La exportación de la caja solo contiene los pagos hechos por la caja. Para un resumen de todos los ingresos, exporta además el historial de la billetera como CSV; contiene cada pago.

7. Reembolso

1. En la billetera, abre en el historial el pago de la caja y elige “Reembolsar”.
2. Ingresa la dirección Lightning o la factura de quien compró. Puedes reembolsar como máximo el monto aún pendiente.
3. Revisa y confirma. El reembolso aparece en el cierre con signo menos. Con direcciones Lightning que aceptan una nota, la billetera envía además “Reembolso del comprobante …”.

La billetera guarda el vínculo “reembolso del comprobante” solo en el dispositivo desde el que hiciste el reembolso. Si un reembolso todavía está en camino, la billetera advierte antes de hacer un segundo.

8. Seguridad y datos

• Dispositivos del personal: la caja no tiene acceso a tu dinero y no puede enviar nada. Las palabras, el PIN y el saldo se quedan en tu billetera.
• Lo que ven otros: la nota de comprobante está cifrada. Las líneas solo se envían dentro de esta nota cifrada; sin clave de comprobantes, se quedan en el dispositivo de caja. Aun así, el servicio de pagos ve el monto, la hora y tu dirección Lightning. Cifrado no significa anonimato. Los detalles están en la política de privacidad (en inglés).
• Dispositivos compartidos: los datos de la caja (dirección, nombre de la caja, contador de comprobantes, últimas facturas, artículos y moneda elegida) se guardan en el navegador del dispositivo de caja. En dispositivos ajenos o compartidos, bórralos con “Otra dirección” o borrando los datos del navegador.

9. Límites

• No es una caja registradora: la caja no es un sistema electrónico de registro con un dispositivo técnico de seguridad certificado (TSE) en el sentido de la KassenSichV (Alemania). Si te corresponde la obligación de usar una caja registradora depende de tu actividad real. Tus obligaciones de registro, de emisión de comprobantes y fiscales las cumples tú (Términos de uso (en inglés)).
• Monto según la caja: la nota de caja no está vinculada de forma fija al pago; quien conozca el enlace de caja podría crear una nota que encaje. La billetera contrasta el monto, el tipo de cambio y las líneas con los sat pagados y señala las desviaciones grandes respecto del tipo de cambio de hoy. Siempre se reembolsa como máximo el monto pagado en sat.
• Resumen, no contabilidad: el cierre y el CSV son un resumen de pagos para ti. No incluyen desglose de IVA ni informe de caja; puedes usarlos como base para tu contabilidad.
• Beta: las funciones pueden cambiar. Guarda las exportaciones mensuales con regularidad. Todavía no hemos comprobado de forma concluyente si, tras un cambio de dispositivo, se recuperan todas las notas de comprobante.

¿Preguntas? Preguntas frecuentes o kontakt@kai-pay.net.