Stripe se conecta con dos claves API y un código de moneda en la tienda. Las tarjetas pueden teclearse o pasarse por banda en el navegador, o — con un lector inteligente Stripe Terminal registrado a la caja — cobrarse con chip y sin contacto, con propinas, tarjetas guardadas, reembolsos y pagos de facturas en línea.

Stripe es una integración vigente y con soporte pleno. No necesita software local: dos claves API y un código de moneda en la tienda bastan para procesar. La tarjeta se ingresa de dos formas — tecleada o por banda en el navegador (el lector de banda USB MagTek 21040108 es el recomendado), o con chip y sin contacto en un lector inteligente Stripe Terminal registrado a una caja. Si todavía comparas opciones, empieza por elegir un procesador de pagos.

Obtén tus claves API de Stripe

1. Crea una cuenta de Stripe en stripe.com si no tienes una.
2. Inicia sesión en el Stripe Dashboard y abre Developers → API keys.
3. Copia la clave secreta live y la clave publicable live. Las claves de modo de prueba no cobran tarjetas reales, así que confirma que estás en modo live.

Configura la tienda

1. Ve a Tiendas y haz clic en Editar junto a la tienda que cobrará con tarjeta.
2. En la sección Integraciones, marca Activar procesamiento de tarjetas de crédito.
3. Pon el Procesador de Tarjeta de Crédito en Stripe.
4. Pega la clave secreta en el campo de clave secreta de Stripe (Stripe Secret Key) y la clave publicable en el campo de clave publicable (Stripe Publishable Key).
5. Define el Código de moneda — el valor por defecto es usd. La documentación de Stripe lista todos los códigos de moneda soportados.
6. Haz clic en Guardar.

Editar tiendas requiere el permiso del módulo Tiendas en tu cuenta de empleado — mira permisos y plantillas. El procesamiento integrado también requiere que el punto de venta se sirva por HTTPS.

Registra un lector Stripe Terminal (opcional, para chip y sin contacto)

Con un lector inteligente Stripe Terminal (por ejemplo un lector de la familia WisePOS comprado a Stripe), cada caja puede controlar su propio dispositivo de mostrador:

1. Enciende el lector y conéctalo a tu red siguiendo las instrucciones de Stripe. El lector muestra un código de registro (en la mayoría: desliza desde el borde izquierdo, entra a ajustes y genera un código de emparejamiento/registro).
2. En el formulario de la tienda, busca la fila de la caja en la tabla de Cajas registradoras y haz clic en Register Stripe Reader (registrar lector Stripe).
3. Cuando pida "Introduzca el código de registro que aparece en el lector Stripe", teclea el código y confirma. El ID del lector queda guardado en esa caja.
4. Para cambiar o quitar un lector después, haz clic en Unregister Stripe Reader (anular registro) en la misma fila.

Con un lector en la caja, elegir el tipo de pago Tarjeta de crédito envía el monto exacto al lector para chip, sin contacto o banda. Una caja sin lector cae a la entrada tecleada/por banda en el navegador. Como el lector se guarda por caja, cada caja puede tener su propio dispositivo — el punto de venta marca cada cargo (salvo las devoluciones) como elegible para propina, y el lector la pide según la configuración de propinas de tu Stripe Dashboard; la casilla Habilitar propinas de la caja no tiene efecto en Stripe.

Qué soporta la integración

• Pagos — tecleados, por banda, o chip/sin contacto vía Stripe Terminal.
• Propinas — se ofrecen en el lector Stripe Terminal al cobrar, según la configuración de propinas de tu Stripe Dashboard. Después de la venta, una propina solo puede agregarse desde Introduzca propinas si la tarjeta se guardó en el cliente; se cobra como una transacción de propina aparte.
• Tarjetas en archivo — guarda una tarjeta del cliente como token seguro de Stripe y cóbrala después; la base de series, paquetes y cargos recurrentes.
• Anulaciones y reembolsos — se ejecutan desde la venta original y la reversión vuelve a la misma tarjeta. Mira cobrar con tarjeta.
• Pagos de facturas en línea — los clientes pueden pagar con tarjeta facturas enviadas por correo y enlaces de pago sin iniciar sesión; mira facturas y cobros.

Referencia de ajustes

• Activar procesamiento de tarjetas de crédito — interruptor maestro, apagado por defecto.
• Procesador de Tarjeta de Crédito — en Stripe.
• Clave secreta de Stripe — la clave secreta live; trátala como una contraseña.
• Clave publicable de Stripe — la clave publicable live.
• Código de moneda — por defecto usd; debe ser una moneda que Stripe soporte.
• Por caja en la tabla de Cajas registradoras: Register Stripe Reader / Unregister Stripe Reader (la casilla Habilitar propinas de la misma tabla no la usa Stripe).

Preguntas frecuentes

¿Stripe soporta terminal de chip y sin contacto, o solo banda? Ambos. La entrada tecleada y por banda funciona en cualquier navegador sin hardware extra; registrar un lector inteligente Stripe Terminal a la caja agrega chip y sin contacto en el mostrador.

Mis cargos no aparecen en Stripe. Revisa que pegaste claves live, no de prueba — las claves de prueba aceptan el formulario pero el dinero nunca se mueve. Ambas claves deben venir de la misma cuenta de Stripe.

¿En qué moneda se cobrará a los clientes? La que diga el Código de moneda de la tienda — usd por defecto. Cámbialo antes de la primera venta real si operas en otra moneda.

El lector dice estar registrado pero las ventas no le llegan. Confirma que el lector aparece en línea en el Stripe Dashboard y en la misma cuenta de tus claves; luego anula el registro y regístralo de nuevo desde la fila de la caja. Si el lector está fuera de línea (cambio de red, reinicio), la caja lo informa en lugar de cobrar.

¿Puedo guardar la tarjeta de un cliente para cobrarle después? Sí — las tarjetas en archivo se guardan como tokens de Stripe asociados al cliente, y sirven para facturas, cargos recurrentes y ventas repetidas. Mira cobrar con tarjeta.

¿Cada tienda puede usar su propia cuenta de Stripe? Sí. Las claves viven por tienda, así que un negocio con varias sucursales puede operar cuentas de Stripe separadas — mira configurar el procesamiento de tarjetas.