Conectar Stripe

Stripe procesa tarjetas de crédito y débito en decenas de monedas. Conectada a Vipter, atiende ventas únicas, suscripciones, order bump y upsell de 1 clic. Stripe no hace PIX ni cuotas: para eso, conecta también Pagar.me, Mercado Pago o Asaas.

Paso 1: copiar la clave secreta en StripeCopiar enlace de la sección

1. Entra al panel de Stripe y revisa arriba en qué entorno estás: el modo de prueba sirve para probar y la cuenta real para vender.
2. Abre Desarrolladores›Claves de API. La dirección directa es dashboard.stripe.com/apikeys.
3. En la fila Clave secreta, haz clic en Mostrar y copia el valor. Empieza con sk_live_ en la cuenta real y con sk_test_ en el modo de prueba.

Paso 2: crear la conexión en VipterCopiar enlace de la sección

1. En el panel de Vipter, abre Pagos›Proveedores›Stripe.
2. Haz clic en Nueva conexión. Si la tienda aún no tiene ninguna cuenta de Stripe, el formulario ya aparece abierto.
3. Completa los campos numerados:

4. Haz clic en Guardar y obtener la URL del webhook. Vipter verifica la clave con Stripe antes de guardar. Si está mal, no se guarda nada y el error aparece en el formulario.

Si es la primera cuenta de tarjeta de la tienda, Vipter crea solo los flujos de pago de tarjeta de crédito y de débito apuntando a ella. La tienda ya puede cobrar después del paso 4.

Paso 3: registrar el webhook en StripeCopiar enlace de la sección

Por el webhook, Stripe le avisa a Vipter lo que pasa después de la compra: reembolsos, disputas, capturas y pagos que piden autenticación. Sin él, esos eventos no llegan a la tienda.

1. Después de guardar, la tarjeta de la conexión muestra la URL del webhook. Cópiala.

2. En Stripe, abre Desarrolladores›Webhooks y haz clic en Añadir destino. En paneles más antiguos, el botón se llama Añadir endpoint.
3. Selecciona todos los eventos de los grupos Charge, Payment Intent y Refund.
4. Elige Endpoint de webhook, pega la URL que copiaste en el punto 1 y guarda.
5. Abre el destino que creaste y copia el Secreto de firma, que empieza con whsec_.

6. Vuelve a Vipter, pega el secreto en la tarjeta de la conexión y haz clic en Guardar secreto.

Paso 4: probar la conexiónCopiar enlace de la sección

1. En la tarjeta de la conexión, haz clic en Probar. Vipter consulta a Stripe con la clave guardada.
2. Haz una compra de prueba en el checkout de una oferta. Con el modo de prueba encendido, usa la tarjeta 4242 4242 4242 4242, cualquier fecha futura y cualquier CVC.

Problemas comunesCopiar enlace de la sección

• Tu plan permite N conector(es) activo(s). Mejora el plan para agregar más.

  Tu plan llegó al límite de conexiones activas. Desactiva una conexión que ya no uses o cambia de plan en Plan Vipter.

• Elige un país que atienda este proveedor.

  Stripe no atiende el país que elegiste. Usa el país donde se abrió la cuenta de Stripe.

• Stripe rechazó la clave

  La clave está incompleta, es de otra cuenta o es de prueba con el modo de prueba apagado (o al revés). Copia de nuevo la clave secreta, no la publicable (pk_), y revisa el interruptor Conexión de prueba.

• Sin el secreto de verificación la plataforma rechaza los eventos de este proveedor. Registra la URL de arriba en el proveedor, copia el secreto y guárdalo aquí.

  El webhook no se registró o el secreto no se guardó. Repite el paso 3.

Qué hacer despuésCopiar enlace de la sección

• Si vendes en Brasil, conecta un proveedor con PIX y cuotas, como Pagar.me.
• Revisa los flujos en Pagos›Flujos de pago para decidir qué cuenta cobra cada pago y cuál queda de fallback.