Para utilizar Stripe como medio de pago en el Marketplace, es necesario integrarlo con Kubo.
Requisitos previos
Antes de comenzar, compruebe que:
-
Tu empresa tenga una cuenta activa en Stripe.
-
El registro de la cuenta esté completo y aprobado.
-
El entorno de producción esté activado.
Instrucciones
Paso 1: obtener las credenciales Stripe Key y Stripe Secret
-
Accede al panel de control de Stripe (dashboard) con tus datos de inicio de sesión
-
Accede a Desarrolladores > Claves de API
-
Desactiva el Modo de prueba y asegúrate de que estás en el entorno de producción
-
Copia la Clave pública, que empieza por
pk_live_ -
Copia la Clave secreta, que empieza por
sk_live_
Si es necesario, haz clic para mostrarla.
Guarde esta información en un lugar seguro y nunca la comparta públicamente.
Paso 2: configurar las credenciales Stripe Key y Stripe Secret en Kubo
-
Accede al menú Marketplace > Configuraciones
-
Haz clic en la pestaña Pago
-
En Medio de pago, habilite la opción Activar de Stripe
-
Rellena los campos Stripe Key y Stripe Secret con las credenciales obtenidas en el Paso 1
Para obtener orientación sobre los demás campos de configuración, acceda a Configurar pago.
-
Haga clic en el botón Guardar
Paso 3: configurar la URL de notificaciones (Webhook)
-
Acceda al menú Marketplace > Configuraciones
-
Haga clic en la pestaña Pago
-
En Medio de pago > Stripe, copie la URL que aparece en el campo Webhook
-
Accede al panel de Stripe
-
Accede a Desarrolladores > Webhooks
-
Haz clic en Añadir endpoint
-
En el campo URL del endpoint, pega la URL copiada de Kubo en el paso 3
-
En Seleccionar eventos a monitorizar, selecciona los eventos de cobro y pago (
charge.succeeded,charge.failed,payment_intent.succeeded, etc.) -
Haz clic en Añadir endpoint para guardar
Paso 4: probar la integración
-
Genera una transacción de prueba con tarjeta de crédito, con un valor mínimo de R$ 1,00, en la plataforma
-
Comprueba si el estado de la compra en Kubo se ha actualizado automáticamente a Pagado
Esta prueba permite comprobar si la integración funciona correctamente y si el registro de los pagos se realiza de forma automática.