Cómo crear una llave restringida de Stripe para conectarla a trazpago

Cuando conectas tu cuenta de Stripe a trazpago, el formulario te pide una llave restringida (empieza con rk_live_) en lugar de tu llave secreta completa (sk_live_). Tu llave completa también funciona —no te bloqueamos—, pero hay una razón de peso para tomarte dos minutos y crear la restringida. Aquí te contamos cuál es y te damos los pasos exactos.

Qué es una llave restringida

Tu cuenta de Stripe tiene una llave secreta completa (sk_live_) que puede hacerlo todo: crear cargos, emitir reembolsos, mover configuraciones, leer los datos de tus clientes. Una llave restringida (rk_live_) es una llave adicional que tú creas y a la que le das solo los permisos que elijas. Todo lo demás queda fuera de su alcance, por diseño de Stripe.

Puedes crear varias, una por herramienta, y revocar cualquiera en cualquier momento sin tocar a las demás ni a tu llave principal.

Por qué trazpago te pide una

Es el principio de mínimo privilegio: cada herramienta debe tener acceso únicamente a lo que necesita para hacer su trabajo, y ni un permiso más.

trazpago organiza tus cobros y les da trazabilidad; no procesa el pago ni custodia tu dinero — el dinero llega directo a tu cuenta de Stripe, a tu nombre. Para eso, lo único que trazpago necesita de Stripe es poder crear las páginas de pago de tus cobros y verificar que la cuenta conectada es la tuya. No necesita emitir reembolsos, ni leer todo tu historial, ni tocar tu configuración — así que lo correcto es que la llave que nos entregas no pueda hacer nada de eso.

Además, tu llave viaja cifrada directo a nuestro guardián en la nube y se guarda cifrada: nunca pasa por nuestros servidores de aplicación y nadie de trazpago puede verla. La llave restringida es la otra mitad de esa misma idea: aunque algo saliera mal en cualquier eslabón, una rk_ con permisos mínimos limita el daño posible a casi nada.

Cómo crearla, paso a paso

1. Entra a tu panel de Stripe y ve a Desarrolladores → Claves de API (dashboard.stripe.com/apikeys). Asegúrate de estar en modo producción, no en modo de prueba.
2. Haz clic en Crear clave restringida.
3. Ponle un nombre que reconozcas después, por ejemplo trazpago. Así, en tu lista de llaves siempre sabrás cuál es de quién.
4. Otorga únicamente estos permisos, y deja todo lo demás en Ninguno:

• Checkout Sessions — Escritura: es lo que le permite a trazpago crear la página de pago de cada cobro tuyo.
• Account (cuenta) — Lectura: solo para verificar que la llave es válida y que la cuenta conectada es la tuya.
• Webhook Endpoints — Escritura: para registrar el aviso con el que Stripe le confirma a trazpago que un pago se completó, y que tu tablero se actualice solo.

1. Haz clic en Crear clave y copia la llave que empieza con rk_live_ — Stripe solo te la muestra completa una vez.
2. Pégala en el formulario de conexión de trazpago (Configuración → Métodos de cobro → Stripe) y listo.

¿Y si ya conecté con mi sk_ completa?

Funciona igual: tus cobros se emiten y tus pagos llegan exactamente igual. La diferencia no está en lo que trazpago hace —que es lo mismo con una llave u otra— sino en lo que esa llave podría hacer: una sk_live_ da acceso a toda tu cuenta de Stripe, mucho más del que trazpago necesita o usa.

Si quieres cambiarla, no hace falta empezar de cero: crea la llave restringida con los pasos de arriba, desconecta Stripe en trazpago y vuelve a conectar con la rk_live_ nueva. Después puedes revocar el acceso anterior desde tu panel de Stripe, sin afectar a ninguna otra herramienta.

Tu llave, tus reglas

La cuenta de Stripe es tuya y el control también: desde tu panel de Stripe puedes ver cada llave, cuándo se usó por última vez y revocarla al instante. trazpago está diseñado para trabajar con ese control a tu favor — pedirte una llave restringida es parte de tratarte como el dueño de tu dinero, que es exactamente lo que eres. No procesamos tus pagos; organizamos tus cobros para que el dinero te llegue directo, con orden y con rastro.