Integrar Asaas con Kubo para su uso en el Marketplace

Para utilizar Asaas como medio de pago en el Marketplace, es necesario integrarlo con Kubo.

Requisitos previos

Antes de comenzar, compruebe que:

• Su empresa dispone de una cuenta activa en Asaas.

• El registro de la cuenta está completo.

• Los documentos de la empresa han sido aprobados.

• La cuenta bancaria para los retiros está validada.

Instrucciones

Paso 1: obtener la clave API de Asaas

1. Accede al panel de control de Asaas con tus datos de inicio de sesión

2. Haz clic en el icono de engranaje, situado en la esquina superior derecha

3. Accede al menú Integraciones

4. Busca la sección Generar clave API o Clave API

5. Copia la clave API (token de acceso) generada

Paso 2: configurar la clave API 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 Asaas

4. Rellene el campo Clave API con la credencial obtenida en el Paso 1

5. 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 > Asaas, copie la URL que aparece en el campo Webhook

4. Accede al panel de Asaas

5. Accede a Configuraciones > Integraciones

6. Busca la sección Webhooks y configura un nuevo webhook

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

8. En la cola de eventos, marca las opciones relacionadas con las actualizaciones de estado (Pago recibido, Pago atrasado, etc.)

9. Guarda la configuración en Asaas

Paso 4: probar la integración

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

2. Realiza el pago

3. Comprueba si el estado del pedido en Kubo se ha actualizado a Pagado en unos instantes

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: August 06, 2026