Skip to main content
La integración de Stripe de Macaly te permite aceptar pagos únicos y recurrentes (suscripciones) directamente dentro de tu proyecto. Se aprovisiona automáticamente un entorno de pruebas totalmente funcional, así que puedes empezar a crear y probar sin una cuenta de Stripe. Cuando estés listo para pasar a producción, conecta tu cuenta de Stripe y cambia al modo Live.
Disponible en los planes Pro y Agencias

​
Añadir pagos a tu proyecto

Descríbele al agente en el chat tus necesidades de pago. Por ejemplo:
El agente crea tu proyecto con un flujo de pago completo y aprovisiona un entorno de pruebas de Stripe en segundo plano. Para añadir pagos, también puedes empezar desde la pestaña Pagos en la barra de navegación superior. Puedes empezar a probar de inmediato usando la tarjeta de prueba que se muestra en la pestaña Pagos: Ve a tu proyecto, completa una compra de prueba y verifica la experiencia de checkout.
También puedes probar escenarios de error como tarjetas rechazadas o datos de pago no válidos usando las tarjetas de prueba dedicadas de Stripe. Consulta la documentación de pruebas de Stripe para ver la lista completa de números de tarjeta de prueba y los errores que simulan.

​
Activar tu área de pruebas segura

Cuando Macaly crea tu entorno de pruebas, aprovisiona un sandbox de Stripe. Este sandbox funciona de inmediato y te permite probar pagos, pero no está vinculado a ninguna cuenta de Stripe. Los sandboxes no reclamados caducan después de 60 días. Reclamar el sandbox lo conecta a tu cuenta de Stripe. Una vez reclamado, el sandbox es tuyo y puedes gestionarlo directamente en la Stripe Dashboard. Puedes reclamar el sandbox de dos formas: desde la pestaña Pagos de tu proyecto, o a través del correo que Stripe te envía después de crear el entorno de pruebas. Reclamarlo es también el primer paso hacia la aceptación de pagos reales. Para pasar a producción, tendrás que reclamar el sandbox, hacer que Stripe verifique tu negocio e introducir tus claves API Live.
1

Abre la pestaña Pagos

Abre la pestaña Pagos en tu proyecto. En “Activar tu área de pruebas segura” verás el botón Reclamar tu sandbox de Stripe.
2

Haz clic en Reclamar tu sandbox de Stripe

Stripe se abre en una nueva pestaña con la página Claim your sandbox.Si ya tienes una cuenta de Stripe, selecciónala de la lista. Si no, haz clic en + Create new account para crear una gratis.Haz clic en Continue para continuar.
3

Indica los datos de tu negocio

Stripe te pedirá información básica:
  1. Nombre y ubicación del negocio. Introduce el nombre de tu negocio y selecciona tu país. Haz clic en Continue.
  2. Sitio web y descripción del negocio. Indica la URL de tu sitio web y una breve descripción de tus productos o servicios. Este paso se puede omitir haciendo clic en Skip.
  3. Uso previsto de Stripe. Selecciona los tipos de pago relevantes para tu negocio (p. ej. pagos únicos o recurrentes). Este paso también se puede omitir.
4

Completa la configuración del sandbox

En la pantalla final, Stripe presenta un resumen de los próximos pasos: completar tu configuración, cambiar al modo Live y empezar a aceptar pagos. Haz clic en Go to sandbox para terminar.
5

Vuelve a Macaly

Vuelve a Macaly. La pestaña Pagos debería mostrar ahora Los pagos están en modo Test en naranja, confirmando que la reclamación se realizó correctamente.
Las actualizaciones de estado pueden tardar unos instantes en sincronizarse. Si el botón de reclamación sigue visible, actualiza la página.

​
Cambiar al modo Live

Cuando estés listo para aceptar pagos reales, necesitas activar tu cuenta de Stripe y conectar tus claves API Live a Macaly.
Eres responsable de todas las obligaciones legales y fiscales relacionadas con los pagos que aceptes a través de tu proyecto. Consulta a un asesor fiscal si tienes dudas sobre tus obligaciones.

​
Activa tu cuenta de Stripe

Antes de poder acceder a las claves API Live, Stripe requiere que verifiques tu negocio. Es un proceso de incorporación estándar que ocurre por completo del lado de Stripe.
1

Abre la Stripe Dashboard

Ve a dashboard.stripe.com e inicia sesión con la cuenta que usaste para reclamar el sandbox.
2

Completa la guía de configuración

Stripe te pedirá que completes la configuración de tu cuenta. Normalmente incluye:
  • Datos del negocio (razón social, dirección, tipo de negocio)
  • Verificación de identidad personal
  • Cuenta bancaria o datos de pago para recibir fondos
Sigue la guía de configuración de Stripe hasta que todos los pasos aparezcan como completados.
3

Espera la verificación

Stripe revisa tu información y activa tu cuenta. Normalmente es instantáneo, pero puede tardar hasta unos días según tu país y tipo de negocio.Una vez verificada, tu cuenta está activa y tus claves API Live estarán disponibles en la Dashboard.
Puedes seguir creando y probando tu proyecto en modo de prueba mientras esperas a que Stripe verifique tu cuenta.

​
Introduce tus claves API Live

Una vez verificada tu cuenta de Stripe, copia tus claves Live en Macaly.
1

Copia tus claves desde la Stripe Dashboard

En la Stripe Dashboard, tus claves API se muestran en la tarjeta API keys en el lado derecho de la página de inicio. También las encuentras en Developers → API keys, al final de la barra lateral.Verás dos claves:
  • La Publishable key empieza por pk_live_.
  • La Secret key empieza por sk_live_.
Copia ambas claves.
Tu clave secreta da acceso completo a tu cuenta de Stripe. No la compartas nunca ni la pegues en el chat.
2

Añade tus claves en Macaly

En la pestaña Pagos, haz clic en Añadir conexión de Stripe. Pega cada clave en el campo correspondiente y haz clic en Guardar claves API. Asegúrate de usar tus claves Live (que empiezan por pk_live_ y sk_live_), no las de prueba (pk_test_ y sk_test_).
3

Cambia al modo Live

Haz clic en Cambiar al modo Live. Macaly reconfigura tu proyecto para usar tu cuenta de Stripe Live. El estado se actualizará a Los pagos están en modo Live en verde.
4

Publica tu proyecto

Publica tu proyecto para desplegar los cambios. Los pagos Live solo se procesan en el sitio publicado, no en la vista previa.

​
Gestionar tu integración

Todos los ajustes de pago son accesibles desde la pestaña Pagos:
  • Abrir Stripe abre la Stripe Dashboard, donde puedes revisar transacciones, emitir reembolsos y seguir los pagos salientes.
  • Cambiar al modo Live / Cambiar al modo de prueba te permite alternar entre entornos en cualquier momento sin afectar al código de tu proyecto.
  • Gestionar conexión de Stripe te permite actualizar tus claves API Live después de la configuración inicial.
  • Probar pagos muestra los datos de la tarjeta de prueba como referencia mientras estás en modo de prueba.

​
Resolución de problemas

Un sandbox es un entorno de pruebas temporal que Macaly crea para ti. Viene con sus propias claves API de prueba y te permite simular pagos sin tocar dinero real. No es tu cuenta de Stripe. Cuando reclamas el sandbox, lo vinculas a tu cuenta real de Stripe. Hasta que lo reclamas, el sandbox es anónimo y caduca después de 60 días.
Asegúrate de usar el número de tarjeta de prueba 4242 4242 4242 4242 con cualquier fecha de caducidad futura, cualquier CVC de 3 dígitos y cualquier código postal. Si el problema persiste, revisa el chat para ver los detalles del error o pídele al agente que diagnostique el flujo de pago.
El modo Test usa el entorno sandbox con claves de prueba. Todos los pagos son simulados y no interviene dinero real. El modo Live usa tu cuenta de Stripe verificada con claves Live. Se cobra dinero real que se ingresa en tu cuenta bancaria. Puedes cambiar entre modos en cualquier momento desde la pestaña Pagos. Cambiar de modo no afecta al código de tu proyecto, solo a qué claves de Stripe están activas.
Reclamar el sandbox y verificar tu cuenta de Stripe son dos pasos independientes. Reclamarlo vincula el sandbox a tu cuenta, pero aún tienes que completar la verificación de negocio de Stripe (identidad, datos del negocio, cuenta bancaria) antes de que se generen las claves Live. Abre la Stripe Dashboard y sigue la guía de configuración para terminar la verificación. Si solo ves claves de prueba (que empiezan por pk_test_ y sk_test_), tu cuenta aún no se ha verificado del todo.
Verificar tu cuenta de Stripe no cambia automáticamente Macaly al modo Live. Tienes que introducir manualmente tus claves API Live en la pestaña Pagos y luego hacer clic en Cambiar al modo Live. Macaly te mantiene en modo de prueba hasta que cambies explícitamente.
Comprueba tres cosas en este orden:
  1. ¿Has publicado tu proyecto? Los pagos Live solo se procesan en el sitio publicado, no en la vista previa.
  2. ¿Tus claves son correctas? Verifica que hayas introducido tu Publishable key (que empieza por pk_live_) y tu Secret key (que empieza por sk_live_). Si pegaste las claves de prueba por error, haz clic en Gestionar conexión de Stripe y actualízalas.
  3. ¿Tu cuenta de Stripe está totalmente verificada? Abre la Stripe Dashboard y comprueba si hay pasos pendientes en la guía de configuración. Stripe puede requerir documentos adicionales antes de procesar pagos Live.
Los sandboxes no reclamados caducan después de 60 días. Abre la pestaña Pagos y haz clic en Configurar un nuevo sandbox para aprovisionar un nuevo entorno. Tu código de pago existente permanece sin cambios. Si ya habías reclamado y verificado tu cuenta de Stripe, tendrás que volver a introducir tus claves Live después de aprovisionar un nuevo sandbox.

​
Datos útiles

  • Se aplican las comisiones de Stripe. Macaly no cobra tarifas adicionales por los pagos. A cada transacción se aplican las comisiones de procesamiento estándar de Stripe (consulta stripe.com/pricing).
  • Caducidad del sandbox. Los entornos de prueba no reclamados caducan después de 60 días. Si ocurre, abre la pestaña Pagos y haz clic en Configurar un nuevo sandbox para aprovisionar uno nuevo.
  • Los webhooks se gestionan automáticamente. Macaly configura y mantiene todos los endpoints de webhook. No se requiere ninguna configuración manual en la Stripe Dashboard.
  • Los entornos de prueba y Live están aislados. Las transacciones de prueba no aparecen en tu cuenta de Stripe Live, y no se realiza ningún cargo real.