Stripe: conecta tu cuenta sin enviar ninguna clave

Si ya integraste una pasarela antes, esperas el ritual de siempre: copiar dos claves y pegarlas en el sistema. Con Stripe en MMNWEB no es así — tú autorizas a la plataforma a cobrar en tu cuenta, y nosotros guardamos solo su identificador. Ninguna clave tuya sale de su lugar.

Los tipos de credencial de Stripe (y de quién es cada una)

Existe además la separación entre sandbox (prueba) y producción (live): cada modo tiene su propio conjunto de claves, y un objeto creado en un modo no existe en el otro — el clásico "el código tiene un bug" que en realidad es modo mezclado.

Por qué no entregas ninguna clave

MMNWEB usa Stripe Connect, tipo Standard: la cuenta Stripe es tuya, completa e independiente — dashboard propio, reportes propios, relación directa con Stripe. Tú eres el merchant of record: disputa (chargeback), fraude y saldo negativo son responsabilidad tuya, no de Fragasoft — elección deliberada: no queremos cargar riesgo de terceros, y tú no quieres un intermediario decidiendo sobre tu venta.

Para cobrar en tu cuenta, la plataforma usa su clave secreta (no la tuya) combinada con el acct_… de tu cuenta. Por eso no existe motivo técnico para que nos pases ninguna clave — el acct_… identifica, no autoriza retiro.

Cómo conectar, paso a paso

1. En el panel de MMNWEB, ve a la configuración de pagos de tu proyecto.
2. Haz clic en "Conectar mi cuenta Stripe".
3. Se te lleva al sitio de Stripe. Inicia sesión (o crea la cuenta) y autoriza el acceso de la plataforma.
4. Stripe te devuelve a MMNWEB y el identificador de la cuenta (acct_…) se guarda automáticamente.
5. Verifica el estado: el método solo aparece en el checkout cuando esté listo (mira la sección de abajo).

En ningún paso escribes o pegas una clave. Antes de conectar, completa el onboarding de Stripe (datos de la empresa, datos bancarios, verificación de identidad) — es donde casi todos se traban, y el motivo está en la sección siguiente.

⚠️ "Conecté, pero el sistema dice que no puedo vender"

Tener un acct_… no significa que la cuenta pueda recibir. Stripe controla dos capacidades separadas: cobro activo (charges_enabled) y transferencias activas (transfers). Una cuenta con onboarding incompleto tiene un acct_… válido y aun así queda sin transferencia — la venta fallaría en silencio o el dinero quedaría atrapado.

Cómo funciona el split

Fragasoft define un porcentaje de comisión para tu proyecto (contractual — tú no lo editas). En el cobro, el porcentaje se vuelve un valor absoluto en centavos enviado como comisión de la aplicación (application_fee_amount) — no se envía porcentaje a Stripe. La propia Stripe separa automáticamente: el neto va a tu cuenta, la comisión va a la plataforma. Nada transita por la cuenta de Fragasoft — es lo que mantiene la operación fuera de las exigencias de custodia de recursos de terceros.

Revocar el acceso

Puedes revocar la autorización en cualquier momento. En una cuenta Standard, sigues con acceso total a tu cuenta, dashboard y datos — lo que se pierde es la capacidad de la plataforma de cobrar por ti. Revocar interrumpe las ventas por MMNWEB; no bloquea tu cuenta Stripe.

Preguntas rápidas

¿Necesito mandar mi clave secreta al soporte? No. Nunca. Si alguien la pide, desconfía — no la necesitamos y no la almacenamos.

Probé en sandbox y funcionó; en producción dio error. Son universos separados. Confirma que la cuenta conectada es la de producción y que su onboarding está concluido.

¿Puedo usar PIX por Stripe? Para PIX con split, el camino de producción de MMNWEB es Mercado Pago.

Fuentes oficiales

Tipos de clave · Buenas prácticas de clave secreta · Referencia OAuth del Connect

Relacionados: Visión general de las integraciones · Mercado Pago (PIX) · Cielo