Integrar Stripe con Kubo para su uso en el Marketplace

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

  1. Accede al panel de control de Stripe (dashboard) con tus datos de inicio de sesión

  2. Accede a Desarrolladores > Claves de API

  3. Desactiva el Modo de prueba y asegúrate de que estás en el entorno de producción

  4. Copia la Clave pública, que empieza por pk_live_

  5. 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

  1. Accede al menú Marketplace > Configuraciones

  2. Haz clic en la pestaña Pago

  3. En Medio de pago, habilite la opción Activar de Stripe

  4. 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.

  1. Haga clic en el botón Guardar

Paso 3: configurar la URL de notificaciones (Webhook)

  1. Acceda al menú Marketplace > Configuraciones

  2. Haga clic en la pestaña Pago

  3. En Medio de pago > Stripe, copie la URL que aparece en el campo Webhook

  4. Accede al panel de Stripe

  5. Accede a Desarrolladores > Webhooks

  6. Haz clic en Añadir endpoint

  7. En el campo URL del endpoint, pega la URL copiada de Kubo en el paso 3

  8. En Seleccionar eventos a monitorizar, selecciona los eventos de cobro y pago (charge.succeeded, charge.failed, payment_intent.succeeded, etc.)

  9. Haz clic en Añadir endpoint para guardar

Paso 4: probar la integración

  1. Genera una transacción de prueba con tarjeta de crédito, con un valor mínimo de R$ 1,00, en la plataforma

  2. 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.

Last updated: