Si algo va mal
Una caja que hace algo raro, con un cliente delante, pone nervioso a cualquiera. Desde el panel basta un toque: eliges qué pasa, la web te dice qué sabe de tu tienda y qué hacer ahora, y si no basta nos mandas la petición: intentamos ayudarte, sin garantía de plazos. El dinero, mientras tanto, sigue en tu wallet: la caja no lo guarda.
Antes que nada No anules ni vuelvas a marcar la venta. Un pago no se anula solo: casi siempre basta con esperar, y la caja dice cómo ha terminado.
- El cliente no consigue pagar
- El pago se queda en espera
- La caja no se abre
- He perdido el móvil, o lo he cambiado
- He dado demasiado cambio, o el cliente ha pagado de más
- Otra cosa
En el panel: «¿Algo va mal?»
En el panel, debajo del nombre de la tienda, está el botón «¿Algo va mal?». También lo encuentras en el menú de tu caja, el botón de arriba, donde estás con el cliente delante. Se abre con seis frases, las que dirías en la caja, y son las mismas de esta página.1 Debajo de cada una:
- «Qué sabe la web de tu tienda»: primero lo que va mal, luego, en una ficha cerrada, lo que funciona. Te habla a ti, con tus palabras. La página se abre enseguida porque solo mira lo que la web ya tiene; si quieres que pruebe también tu dirección Lightning, toca «Comprobar de nuevo» (tarda hasta 20 segundos).
- «Qué hacer ahora», paso a paso.
- «Pide ayuda a la Valley»: si no basta, un toque, y la petición nos llega con lo que sabe la web. Cómo funciona está más abajo, en Pide ayuda con un toque.
Esta página sirve a quien no está en el panel, o quiere leer antes: dice lo mismo, caso por caso.
El cliente no consigue pagar
Qué ves
La wallet del cliente da error, o el código no se lee, o la caja no muestra ningún código.
Qué haces ahora
- Empieza otra vez la venta desde la caja: aparece un código nuevo. Un código viejo puede dejar de funcionar, y si la caja dice «Pago caducado» el cliente no ha pagado nada.
- Pídele al cliente que lea el código desde dentro de su app wallet, no con la cámara del móvil, y que compruebe que en la wallet tiene suficiente. ¿El código no se lee? Toca «¿No se lee el código? Muéstralo como texto»: el cliente lo puede copiar.
- Si la caja no muestra ningún código o la página no se abre, mira la conexión del móvil y recarga la página.
- ¿El cliente no tiene wallet, o no sabe cómo se paga? Enséñale la ficha para los clientes sin wallet: no tienes que explicar nada.
- ¿En el panel ves «Lightning: tu dirección no responde»? Toca «Vuelve a probar ahora». Luego abre tu wallet: ¿la dirección Lightning sigue siendo esa? Si ha cambiado, pon la nueva desde el panel: la tienda y el cartel siguen siendo los mismos. Si es la misma, tu proveedor puede tener un problema: vuelve a probar dentro de un rato, o pide ayuda.
- No hagas esperar al cliente: si has configurado on-chain, «OK, on-chain» es otro camino; si no funciona nada, puede pagar de otra manera. Después pide ayuda.
Qué hace la web sola
La web prueba tu dirección cada pocas horas, como la usa la caja: pide una solicitud de pago que nadie paga, y en la wallet de vez en cuando la ves caducada. Si deja de responder te escribe (al correo con el que entras, en el chat de Telegram de la tienda si lo has indicado, y en el panel), y te vuelve a escribir cuando vuelve a funcionar. Lo vemos también nosotros, en la lista de cosas que mirar.
El pago se queda en espera
Qué ves
La caja dice «Esperando el pago», y el cliente jura que ha pagado (en su móvil pone «Enviado»).
Qué haces ahora
- No le pidas al cliente que pague otra vez, no anules, no vuelvas a marcar, y no entregues todavía. Quien trabaja contigo espera la marca verde de la caja, no mira el móvil del cliente.
- Con Lightning bastan unos segundos. Si pasan más, comprueba que el móvil de la caja tenga wifi o datos.
- Si la caja dice «Sin conexión», espera: el pago aparece en cuanto vuelve. Si dice que no ha salido nada, pulsa otra vez OK cuando haya conexión.
- Tú, que tienes la wallet, abre tu wallet: ¿ha llegado el dinero? Si es así, el pago es bueno aunque la caja siga esperando: toca «Veo el pago en mi wallet», y en el cierre del día esa venta queda entre las que hay que comprobar. Si pasa a menudo, pide ayuda: intentamos entender por qué la caja no se ha dado cuenta.
- ¿El dinero no está? Un pago Lightning es inmediato: el cliente mira su wallet y vuelve a intentarlo. Un pago on-chain, escrito directamente en el registro de Bitcoin, puede tardar de unos minutos a una hora.
- Abre el historial de la caja: cada venta tiene su estado y dice cómo ha terminado.
Qué hace la web sola
La caja le pregunta a tu wallet, cada pocos segundos, si el pago ha llegado. La venta se queda en el historial hasta que termina: pagada, caducada o anulada. Un pago on-chain visto pero todavía no confirmado lo puedes dejar ahí, con «Siguiente cliente», y la caja lo vuelve a comprobar después.
La caja no se abre
Qué ves
La página de la caja no carga, o dice «La web no responde».
Qué haces ahora
- Comprueba el wifi o los datos del móvil, y vuelve a probar al cabo de un minuto.
- ¿Has perdido el enlace de la caja? Desde el panel toca «Abrir la caja». Si te pide entrar, entra con el enlace que te mandamos al correo con el que te registraste. Con la wallet solo si la has vinculado a tu cuenta («Tu cuenta», «Entra también con una wallet»): si no, la wallet abre una cuenta nueva y vacía.
- ¿Una persona que trabaja contigo no consigue abrir su caja? El código de su ficha vale una sola vez y dura un día: si ha caducado, hazle uno nuevo desde el panel: «Cajas para quien trabaja contigo», luego «Ponla en un móvil» junto a su nombre.
- En un móvil que ya la ha abierto, la caja cobra con Lightning aunque la web no responda: la factura, es decir, la solicitud de pago de Lightning, se la pide directamente a tu dirección. Pulsa «Veo el pago en mi wallet» solo si lo ves de verdad en la wallet de la tienda. Si no lo ves, no entregues y pide ayuda.
Qué hace la web sola
El dinero va siempre directamente a tu wallet: la web no lo toca. Una dirección Lightning impresa sigue siendo válida. La caja habla directamente con tu wallet: si la web no responde, en un móvil que ya la ha abierto sigue funcionando igual. Las ventas están en el móvil, y la web no las ve.
He perdido el móvil, o lo he cambiado
Qué ves
Ya no consigues entrar desde el móvil que usabas, o podría tenerlo otra persona.
Qué haces ahora
- El móvil de una persona que trabaja contigo: desde el panel, en «Cajas para quien trabaja contigo», abre las cajas y toca «Apagar» junto a su nombre. Esa caja se para enseguida y las demás siguen. Para el móvil nuevo haz una caja nueva, con un código nuevo.
- Tu móvil, para la caja: entra desde el móvil nuevo con el enlace que te mandamos por correo, o con la wallet si la has vinculado a tu cuenta, y toca «Abrir la caja»: añádela a la pantalla del móvil nuevo. En la caja no hay dinero ni palabras de recuperación: solo sabe pedir pagos, y te llegan a ti. El historial de ventas estaba en el móvil viejo: vuelve a poner la última copia cifrada que descargaste, con su contraseña, y vuelve todo lo que había hasta ese día. Los ajustes de on-chain, si los usas, los vuelves a escribir.
- El móvil con la wallet: la wallet se vuelve a poner en un móvil nuevo con las doce palabras que escribiste en papel. Nosotros no las tenemos y no podemos recuperarlas. Déjale dicho a una sola persona de confianza dónde encontrar la hoja, por si te pasa algo: las palabras no las lee ni las fotografía nadie.
- ¿También la wallet es nueva? Desde el panel toca «Editar» y luego «Cambia la dirección Lightning», y pon la dirección de la wallet nueva: solo lo puedes hacer tú, habiendo entrado hace poco. La tienda, su página y el cartel siguen siendo los mismos; cada caja la vuelves a abrir confirmando el cambio. Si te atascas, pide ayuda.
Qué hace la web sola
La caja de una persona que trabaja contigo no ve tus ventas ni los ajustes, y no puede cambiar adónde va el dinero. Apagada, ya no acepta pagos nuevos, pero durante un día todavía se abre: una venta que ya está en la pantalla termina ahí, y se descarga la copia del turno.
He dado demasiado cambio, o el cliente ha pagado de más
Qué ves
El cliente ha pagado dos veces, o en on-chain ha mandado más de lo debido. O has dado tú demasiado cambio.
Qué haces ahora
- Entrega la mercancía: la venta está pagada.
- Comprueba en tu wallet que la cantidad de más ha llegado de verdad. Si no está, no devuelves nada.
- Abre el historial de la caja: cada venta tiene el importe, los satoshis y el cambio de ese momento. De ahí sabes cuánto devolver.
- Devuelve la diferencia desde tu wallet, no desde la caja. Si el cliente está de acuerdo, también en efectivo. Si trabajas en la caja y no eres el titular, apuntas hora e importe y lo llamas: devuelve el titular, nunca con dinero tuyo.
- ¿Has dado tú demasiado cambio? La caja no puede recuperar ese dinero, y un pago ya hecho no cambia. El historial te da el importe correcto de la venta, para tus cuentas.
Qué hace la web sola
Nada: el dinero y las ventas son tuyos. La web no ve los pagos, no le manda nada al cliente y no lleva cuentas. El dinero lo devuelves tú, y el historial de la caja te dice cuánto.
Otra cosa
Qué ves
Algo no cuadra y ninguno de los apartados de arriba se le parece. No pasa nada: ocurre, y basta con decírnoslo en una línea.
Qué haces ahora
Desde el panel toca «¿Algo va mal?», luego «Otra cosa», y pide ayuda: una línea sobre qué ves y desde cuándo, e intentamos mirar todo lo que la web sabe de tu tienda.
¿No consigues entrar en el panel? Entonces escribe a info@bitcoinvalley.eu, con cuatro cosas: el nombre de la tienda, la hora, qué pone en la pantalla (también vale una foto) y cómo prefieres que te contactemos. Intentamos responderte, sin garantía de plazos.
Una sola cosa no va nunca en el mensaje, ni en la web ni por correo: las doce palabras de la wallet. A nosotros no nos hacen falta nunca, y la web las rechaza.
Qué hace la web sola
Quien mira tu petición tiene una herramienta que lee tu tienda y dice, en palabras sencillas, qué va mal: la dirección Lightning, el primer día, las cajas de quien trabaja contigo. Las ventas no: están en tu móvil. Solo lee: no cambia nada en tu tienda, y «¿Algo va mal?» no te pide nunca una dirección ni una clave.
Pide ayuda con un toque
Debajo de cada frase del panel está «Pide ayuda a la Valley».1
- Una línea, si quieres. Escribe qué ves y desde cuándo, en pocas palabras (hasta doscientos caracteres, en una sola línea). Una clave o las palabras de la wallet, la web las rechaza.
- Cómo prefieres que te contactemos. Por correo, a la dirección con la que entras (el panel la muestra con algunas letras ocultas); por Telegram, en el chat de la tienda; al teléfono de la tienda; o «Miraré mi panel: dice cuándo está resuelta».
- Qué nos llega. El nombre de la tienda, qué pasa, tu línea, cómo contactarte (la forma, nunca la dirección ni el número) y lo que la web sabe de tu tienda en ese momento. Nunca una clave, nunca una dirección. La petición está arriba del todo en nuestra lista; cuando está arreglada, alguien la marca como «resuelta».
- Qué ves tú. En el panel «Has pedido ayuda a las 10:32» y luego «Resuelta», durante tres días. Si el mensaje no nos llega (no hay Telegram, o no responde), la petición queda guardada igualmente y el panel te lo dice.
Hasta tres peticiones al día por tienda. No es un chat: intentamos contactarte como has pedido, sin garantía de plazos, y marcamos la petición como «resuelta» cuando está arreglada. Qué podemos hacer y qué no: las condiciones de la ayuda.
«¿Algo va mal?» no cambia nunca la caja, el cartel, las cajas de quien trabaja contigo ni adónde va el dinero.
Qué prepara la web para nosotros, sin que tú hagas nada
La web nos prepara una lista de cosas que mirar:1 las direcciones Lightning que no responden y desde cuándo, las tiendas que se han mudado y todavía esperan al titular o la wallet. Tu tienda está si tiene un problema, y las peticiones de ayuda van arriba del todo. Cuando conseguimos mirarla, parte de lo que sabe la web; los plazos no los podemos garantizar.
Tus ventas no las vemos: se quedan en el móvil de la caja y en las copias que descargas tú. La clave pública on-chain, si la usas, también está en la caja. No vemos el saldo de tu wallet, y no podemos gastar tu dinero ni parar tus cobros.
→
La hoja para tener detrás de la caja Las preguntas de la tienda El primer día, hora a hora La guía para las tiendas
-
Lo que hacen la caja y el panel, según lo describe la documentación de bitmentor (github.com/mammadori/bitmentor, carpeta
docs/features: «The practice register», «Staff and shops kept apart», «Closed for a while», «The customer at the till», «Something wrong?», «History and day closing», «On-chain at the register», «Registers for the staff») y como se ve en el panel del comercio. Leídos el 10 de noviembre de 2026, revisados de nuevo el 12 de noviembre. ↩↩↩