Estás leyendo la documentación de 1.0.4. La versión actual es 1.0.6.Ir a 1.0.6
Pagos con tarjeta
En esta página
Con la edición Premium, el cliente paga con tarjeta en la tableta del cliente y el pago llega solo a la cuenta del ticket: nadie escribe un importe ni copia una referencia. El segundo monitor muestra todo lo demás, pero solo la tableta cobra con tarjeta.
Un proveedor para la tienda
| Stripe | PayPal Zettle | |
|---|---|---|
| Cómo paga el cliente | Acerca una tarjeta o un teléfono a la parte trasera de la tableta (Tap to Pay) | Usa su lector Zettle, manejado por la tableta |
| Equipo adicional | Ninguno, pero la tableta debe cumplir (Android 13 o posterior, NFC, opciones de desarrollador desactivadas) | Su lector de tarjetas Zettle (Bluetooth) |
| Reembolsos | Desde la cuenta: Reembolsar con Stripe | En la aplicación Zettle, y luego se registran en la cuenta |
| Comisión de cada pago | Se registra tal como la informa Stripe (o su tasa) | Se registra con su tasa de tarjeta |

Configurarlo
Abra Configuración → Pagos con tarjeta. Necesita el permiso Configurar pagos con tarjeta; los administradores y desarrolladores lo tienen. En Proveedor, elija Quién cobra la tarjeta: ninguno, Stripe o PayPal (Zettle). Las claves quedan en el servidor, nunca en la tableta.
Stripe
- En el panel de Stripe, abra Developers, API keys y copie la clave secreta (
sk_live_..., osk_test_...para probar primero). Péguela en Clave secreta y presione Guardar. - Compruebe que la dirección del Perfil de la empresa esté completa y presione Crear la ubicación con la dirección de la empresa. Stripe necesita esta Ubicación de Terminal para Tap to Pay.
- En el panel de Stripe, abra Developers, Webhooks y agregue un endpoint con la Dirección del webhook que muestra la página (use el botón para copiarla). Marque los eventos
payment_intent.succeeded,payment_intent.payment_failed,payment_intent.canceledycharge.refunded. - Copie el secreto de firma del endpoint (
whsec_...) en Secreto de firma del webhook y presione Guardar. El webhook es la red de seguridad: si el mostrador pierde la conexión justo después de que el cliente pagó, Stripe igual avisa a Ledger Desk. - Presione Probar la conexión. Muestra su cuenta de Stripe, o el error de Stripe.
- En la pantalla de administración de la tableta, la línea de pagos debe decir que Stripe Tap to Pay está listo.
Stripe necesita poder llegar a Ledger Desk para el webhook. Nuestro equipo lo prepara con su servidor. Un reembolso que haga en el panel de Stripe se registra solo en la cuenta, nunca dos veces.
PayPal Zettle
- En el portal de desarrolladores de Zettle, cree una app para el SDK de Android con la dirección de retorno
ledgerdesk-screen://zettley copie su Id de cliente. - Cree una Clave de API que pueda leer las compras. Es obligatoria: Ledger Desk registra un pago de Zettle solo después de encontrar la compra con esta clave.
- En Configuración → Pagos con tarjeta elija PayPal (Zettle), complete el id de cliente y la clave de API, Guardar, y luego Probar la conexión.
- Presione Registrar el webhook de Zettle para que Zettle avise de cada compra. El perfil de la empresa necesita un correo. Si usted creó la suscripción, pegue su Clave de firma del webhook.
- En la pantalla de administración de la tableta presione Iniciar sesión en Zettle, entre con la cuenta Zettle de la tienda y luego Emparejar el lector Zettle. La línea de pagos debe decir listo.
Al final, la página indica si todo está listo o qué falta.
Recargo y comisiones
- Añadir un recargo a los pagos con tarjeta está desactivado por defecto. Al activarlo, se suma un porcentaje (como máximo 3%) a lo que el cliente paga con tarjeta en la tableta.
- El cliente ve el importe, el recargo y el total con un aviso antes de leer la tarjeta. Escriba su propio aviso para el cliente en inglés y en español, o deje el estándar.
- El recargo se guarda en el pago, no en la cuenta: la cuenta y su impuesto quedan como se emitieron. Los recibos y las facturas lo imprimen bajo su pago.
- Comisión del proveedor: La comisión exacta que informa el proveedor (Stripe; Zettle usa su tasa), La tasa de tarjeta de la empresa (en el Perfil de la empresa) o Sin comisión. Las comisiones bajan la ganancia y la base de las comisiones del personal; pérdidas y ganancias muestra las comisiones de tarjeta menos los recargos cobrados.
En Estados Unidos no se permite recargo en tarjetas de débito, tiene un tope cercano al 3% y está prohibido en algunos estados, y hay que avisar al cliente antes de pagar. Aquí el recargo no lleva impuesto. Consulte a su contador antes de activarlo.
Cobrar
- Abra el ticket. Su cuenta puede estar emitida o ser aún un borrador: un borrador se emite solo cuando el cliente paga.
- Presione Pagar en la tableta. Revise el importe; puede bajarlo para un pago parcial. Presione Enviar a la tableta.
- El mostrador espera al cliente. La tableta muestra el importe (y el recargo). El cliente presiona Pagar y acerca la tarjeta o usa el lector.
- Ledger Desk comprueba el pago con el proveedor y lo registra en la cuenta. El mostrador indica que se pagó en la tableta, y puede imprimir el recibo.

El botón aparece solo cuando hay un proveedor configurado, la pantalla del cliente es una tableta conectada y la tableta dice que está lista. Una cuenta tiene un solo pago con tarjeta a la vez en la tableta; mientras espera, su importe queda reservado, así que un pago a mano solo puede tomar lo que queda.
Rechazado, cancelado, aún en verificación
- Rechazada o no se pudo leer: el cliente puede intentarlo de nuevo en la tableta.
- Cancelar el pago en el mostrador (o Cancelar en la tableta) lo detiene. Ledger Desk pregunta antes al proveedor: una tarjeta ya aceptada se registra en lugar de cancelarse.
- El pago aún se está verificando: la tarjeta se cobró y Ledger Desk lo registra solo. No vuelva a cobrar.
- Un cobro que ya no se puede registrar (la cuenta se anuló o cambió mientras tanto) se devuelve solo a la tarjeta con Stripe. Con Zettle queda marcado para revisar, y todos los que cobran reciben un aviso en la campana; reembólselo en la aplicación Zettle.
- Un pago que nadie termina se abandona a los 30 minutos, una vez que el proveedor confirma que no se cobró nada.

Reembolsos
- Stripe: en la fila del pago de la cuenta presione Reembolsar con Stripe, indique el importe y un motivo. El dinero vuelve a la tarjeta (el cliente no necesita la tarjeta) y el reembolso se registra en la cuenta. Como máximo lo que pagó ese pago, menos lo ya reembolsado; el recargo vuelve en proporción.
- Zettle: reembolse en la aplicación Zettle y luego registre el reembolso en la cuenta en Ledger Desk.
- Un pago tomado por un proveedor no se puede anular en la cuenta: el dinero está en la tarjeta, así que vuelve como reembolso.
Se guarda cada intento, sin datos de tarjeta
- Cada intento con tarjeta queda en el historial: Aprobado, Rechazado, Fallido o Cancelado. Un intento nunca se cambia ni se borra.
- La cuenta muestra una tarjeta Intentos con tarjeta cuando tiene intentos.
- Pagos, pestaña Transacciones con tarjeta, lista todos los intentos de la tienda con filtros (días, resultado, proveedor, búsqueda por cuenta, referencia, persona o tableta) y Exportar CSV (requiere el permiso de exportar informes).
- Nunca se lee, guarda ni envía el número de la tarjeta, los últimos dígitos, la marca, el vencimiento ni el titular, ni en la tableta, ni en el mostrador, ni en el servidor. El motivo de un rechazo se guarda con las palabras del proveedor y solo lo leen quienes configuran los pagos con tarjeta.
Sin pagos con tarjeta sin conexión
Cuando no se puede conectar con el servidor (vea Modo sin conexión), Pagar en la tableta no se ofrece y la cuenta explica por qué. Cobre en efectivo, con cheque u otro pago a mano; los pagos con tarjeta en la tableta vuelven en cuanto se pueda conectar con el servidor.
Códigos que puede ver
| Código | Significado | Qué hacer |
|---|---|---|
| LDK-4030 | No hay proveedor configurado o falta una clave | Termine la configuración de arriba |
| LDK-4031 | El proveedor rechazó o no respondió | Revise las claves y la conexión a internet |
| LDK-4032 | El proveedor aún no muestra el pago como pagado | Espere; se revisa de nuevo cada 5 minutos |
| LDK-4033 | El pago ya terminó o se canceló | Vuelva a cargar el ticket |
| LDK-4034 | El importe cobrado no coincide | No se registró nada; Stripe devuelve el cobro, una compra de Zettle necesita un reembolso en la aplicación Zettle |
| LDK-4035 | Ya hay un pago con tarjeta esperando en esta cuenta | Termínelo o cancélelo primero |
| LDK-4036 | El pago se tomó con el proveedor | Reembólselo en lugar de anularlo |
| LDK-C013 | La tableta no puede cobrar ahora | Mire la línea de pagos de la pantalla de administración de la tableta |
Última actualización: 31 de octubre de 2026