Sin contracargos
Un pago Lightning es definitivo una vez que se liquida. No hay tarjeta que disputar ni reservas retenidas.
PARA EMPRESAS DE POS
Agrega Bitcoin Lightning
a tu POS.
Dale a tus comercios una opción de pago con Lightning dentro del punto de venta (POS) que ya usan. Tu backend usa dos endpoints: uno solicita una factura y el otro te dice cuándo está pagada. Tú conservas la venta, el pedido y el cliente; los bitcoin van directo a la billetera del comercio.
O escribe a hello@satsrail.com. Para software de POS en iOS, Android, escritorio y web. Sin hardware nuevo: funciona con tu pantalla y tu conexión a internet actuales. ¿Listo para desarrollar? Lee la guía de integración (en inglés). ¿Quieres dar de alta a tus comercios por ellos? Mira el programa de revendedores.
TU POS
Venta #1042
$25.00
Elige un método de pago
Tarjeta Efectivo
Bitcoin Lightning
Pago confirmadoTu POS completa la venta.
Tu equipo diseña la experiencia dentro de tu POS.
Conserva tu POS Los comercios cobran directamente 0% de comisión por transacción de SatsRail Cuenta gratis · prueba con un pago real pequeño
POR QUÉ AGREGAR LIGHTNING
Bueno para tus comercios.
Simple para ti.
Se liquida en segundos
El cliente aprueba en su propia billetera y la billetera del comercio lo recibe al momento, no en días.
Sin porcentaje por venta
Los comercios pagan a SatsRail un plan mensual fijo, gratis hasta — al mes en pagos en bitcoin, y 0% por pago. Ver precios.
Nada que custodiar
Los fondos van directo a la billetera de cada comercio, así que tu empresa nunca toca el dinero. No hay red de tarjetas ni adquirente que integrar, y SatsRail no le cobra nada a tu empresa por desarrollarlo.
LA INTEGRACIÓN
Integración POS con Lightning:
dos endpoints en tu backend.
- Solicita un pago con el total de la venta. SatsRail le pide una factura Lightning al proveedor de billetera del comercio y te la devuelve.
- Muestra la factura como QR. El cliente la escanea con su billetera.
- Consulta el estado hasta que
paidsea verdadero; luego cierra la venta e imprime tu recibo. Los webhooks opcionalespayment.receivedtambién pueden avisar a tu backend.
# 1. Solicita un pago por el total de la venta POST /api/v1/m/payment_requests { "payment_request": { "amount_cents": 2500, "payment_method": "lightning" } } → 201 { "id": "4e14…", "payment_request": "lnbc…" } # 2. Consúltala y cierra la venta GET /api/v1/m/invoices/4e14…/status → 200 { "status": "paid", "paid": true }
- Reintentos. Envía un
Idempotency-Key: un reintento con la misma clave recibe la primera respuesta durante 24 horas. Crea un solo pago por venta a la vez. - Claves. Guarda la clave secreta en tu backend, nunca en la app de la terminal.
- Límites. Por clave, iguales en todos los planes: — solicitudes por minuto y — por hora (planes).
- Consultar el estado. Deja de consultar cuando se cierra la pantalla de pago, y comparte una sola consulta entre terminales. Deja que te avisen los webhooks
payment.receivedo consulta cada 30 segundos aproximadamente: un QR abierto 15 minutos y consultado cada 10 segundos usaría 90 de las — solicitudes de la hora.
EN EL MOSTRADOR
Una forma más de pagar.
El mismo checkout de siempre.
- 01
El cajero elige Lightning
Un botón de pago más en el POS que ya usa. Sin dispositivo nuevo y nada que instalar para el cajero.
- 02
El cliente paga desde su billetera
Cualquier billetera Lightning, o la app de un exchange que pague facturas Lightning, escanea el mismo QR. El cliente aprueba el monto en su teléfono.
- 03
Tu POS imprime su recibo
En cuanto se confirma el pago. Los bitcoin ya están en la billetera del comercio: no hay lote que liquidar ni pago que esperar.
Billetera del cliente → billetera del comercio
Los bitcoin van directamente al comercio. SatsRail nunca retiene los fondos.
Tu POS sigue siendo la fuente de verdad: el catálogo, el carrito, los impuestos, el inventario, los datos de clientes y los recibos se quedan en tu sistema. No hace falta migrar el catálogo ni sincronizar carritos; SatsRail guarda solo el registro del pago. On-chain está en acceso anticipado por la API; pídenos sus notas.
QUÉ IMPLICA LA INTEGRACIÓN
Requisitos de la integración.
En el hardware que ya usas.
Tu equipo desarrolla
- Una opción de Lightning en la pantalla de pago.
- Una conexión de backend para solicitar facturas y consultar su estado.
- La visualización del QR y la confirmación del pago.
- La recuperación cuando una terminal se reconecta o una factura vence.
Es una integración de software a medida. Requiere acceso al código de tu POS o a un punto de extensión compatible.
Tus comercios conectan
- Una cuenta de comercio en SatsRail.
- Una billetera Lightning compatible, conectada con una Lightning Address.
- Una terminal conectada a internet que pueda mostrar un código QR.
- Un país donde operamos: los montos van en la moneda del propio comercio.
Los pagos se liquidan en bitcoin, a la billetera Lightning del comercio o, en on-chain (acceso anticipado), a direcciones nuevas derivadas de la clave de solo lectura del propio comercio. La conversión bancaria, si hace falta, se gestiona por separado con un exchange. Mira las opciones para configurar la billetera
Los comercios se suscriben directamente a SatsRail. 0% por pago.
Gratis hasta — al mes en pagos en bitcoin; después, Starter a — al mes sin límite, o Pro a — (próximamente); precios según la categoría del negocio. Tu empresa nunca queda en medio del flujo de dinero. Pueden aplicar por separado costos de billetera, de red y de conversión.
ANTES DE DESARROLLAR
Preguntas sobre la integración POS.
¿Encaja con tu POS?
¿Cuánto nos cuesta?
Nada. La cuenta de SatsRail y la API son gratis. Probar el estado pagado requiere un pago real pequeño, que llega a la billetera del propio comercio. Cada comercio paga su propio plan de SatsRail, gratis hasta — al mes en pagos en bitcoin, con 0% por pago.
¿Los comercios tienen que verificar su negocio?
Solo para superar — al mes en pagos en bitcoin. El plan gratuito no pide verificación del negocio; los planes pagos sí la requieren (KYB).
¿Cómo se conectan los comercios a nuestro POS?
Cada comercio abre una cuenta en SatsRail, conecta una billetera Lightning con una Lightning Address y crea una clave secreta de API que puede crear solicitudes de pago y leer el estado de las facturas. Tu backend guarda esa clave para el comercio y hace las llamadas.
¿Cuánto tarda una integración?
La parte de la API es pequeña: dos endpoints en tu backend. La mayor parte del trabajo es tu pantalla de pago y los casos límite, como una factura que vence o una terminal que se reconecta. La guía de integración (en inglés) enumera cada estado que debes probar antes de salir en vivo.
¿Tenemos que usar el POS de SatsRail?
No. Tus comercios siguen usando tu POS. SatsRail aporta la conexión de pago detrás de la opción de Lightning que agregues. (Los comercios sin POS pueden usar el POS en el navegador de SatsRail.)
¿Funciona en terminales Android y en iPad?
Sí, si tu app puede comunicarse con tu backend y mostrar un código QR. Tu backend guarda la clave secreta de API del comercio y llama a SatsRail; nunca pongas la clave en la app. El mismo enfoque sirve para software de POS en iOS, escritorio y web.
¿Qué pasa cuando un comercio supera el plan gratuito?
Solo el plan gratuito tiene un límite mensual. Cuando un comercio en ese plan supera — en un mes, las nuevas solicitudes de pago reciben HTTP 429 con el error volume_limit_exceeded hasta que elija un plan pago. No es el límite de solicitudes, que envía un encabezado Retry-After: reintentar no lo resuelve antes de que termine el mes, así que avísale al cajero que el plan de SatsRail del comercio necesita una mejora. Las consultas de estado de facturas abiertas (GET /api/v1/m/invoices/:id/status) siguen funcionando, y SatsRail le escribe al comercio al llegar al 80% y al 100% del límite. Los planes pagos no tienen límite.
¿Cómo probamos la integración?
Las solicitudes de pago siempre son reales, uses la clave de API que uses: cada una devuelve una factura real de la billetera del comercio. Así que prueba el flujo completo, incluido el estado pagado, con un pago real pequeño; llega a la billetera del propio comercio. Solo para desarrollar pantallas, la API de pedidos con una clave de prueba (sk_test_) devuelve facturas simuladas, que nunca se pagan. En ambos casos, la cuenta del comercio debe estar configurada antes, con una billetera Lightning conectada y los acuerdos aceptados.
¿Tenemos que mover pedidos o datos de clientes?
No. Envía el monto final y guarda en tu propio sistema la relación entre el pago y tu venta. SatsRail crea un pedido interno mínimo para el registro del pago; no necesita tu carrito ni los datos de tus clientes.
¿Qué pasa si una terminal pierde la conexión?
SatsRail sigue monitoreando la factura. Cuando la terminal se reconecta, tu sistema consulta el ID de factura guardado y actualiza la venta. Tu integración debe resolver esta recuperación antes de mostrar un resultado final.
¿Podemos dar de alta a nuestros comercios?
Sí, como revendedor de SatsRail. Desde tu área de revendedor, tu equipo crea la cuenta de cada comercio (su propietario recibe una invitación), sigue su configuración y su KYB, y atiende primero sus tickets de soporte. Cada comercio conecta su propia billetera y se suscribe directamente a SatsRail, así que nunca quedas en medio del flujo de dinero. Mira el programa de revendedores.
¿Podemos integrar SatsRail en nuestro producto?
Sí, como lo describe esta página: cada comercio abre su propia cuenta en SatsRail, acepta los Términos y se suscribe directamente, y tu backend llama a la API con la clave de ese comercio. Lo que los Términos (sección 13.3) no permiten sin un acuerdo aparte es revender o sublicenciar SatsRail en sí, por ejemplo vender acceso a SatsRail dentro de tus propios planes. Para otro tipo de acuerdo, .
¿Los comercios pueden seguir aceptando tarjetas y efectivo?
Sí. Lightning es un método de pago adicional en tu POS. Los clientes que lo elijan necesitan bitcoin en una billetera compatible con Lightning.
¿Podemos ofrecer bitcoin on-chain?
Sí, en acceso anticipado, por la API (payment_method: "onchain"); sus notas aún no están en la referencia pública, así que . Tu integración debe mostrar la dirección o el código QR y un estado de "pago visto" mientras el pago espera su confirmación. On-chain no tiene modo de prueba: necesita una clave real. La app de POS de SatsRail es solo Lightning.
VEAMOS TU POS
Lleva Lightning
a tus comercios.
Cuéntanos en qué funciona tu POS y cómo es tu checkout. Te ayudamos a trazar la integración y te respondemos en menos de 24 horas, o escribe a hello@satsrail.com.
- Sin custodia: nunca retenemos fondos
- Seguridad
- Servicio Lightning revisado por un despacho legal independiente
- SatsRail LLC, California
- Respuesta en menos de 24 horas