Comenzar

Procesamiento de pagos de YooKassa

Integración de YooKassa: guía de procesamiento de pagos

Conecta tu iSales AI Chatbot con YooKassa para ofrecer una amplia gama de métodos de pago localizados populares en Rusia y los países de la CEI. Esta guía te ayudará a configurar la integración de YooKassa para que tu bot pueda procesar pagos de tus productos y servicios sin problemas.

Estado de integración de YooKassa:

  • Estado de YooKassa: (por ejemplo, 🟡 Desactivado / Inactivo) – Este indicador muestra si el procesamiento de pagos de YooKassa está activo o no en este momento para tu chatbot de IA.

Ajustes esenciales de conexión de YooKassa:

Para vincular tu iSales AI Chatbot con tu cuenta de YooKassa, necesitarás las siguientes credenciales:

  • ID de cuenta de YooKassa: (por ejemplo, no configurado)

    • Qué es: tu identificador único de tu tienda o cuenta dentro del sistema YooKassa.
    • Cómo encontrarlo: inicia sesión en tu cuenta personal de YooKassa (panel de comerciante). Tu Account ID (a menudo llamado shopId) estará disponible en los ajustes de tu cuenta o en los detalles de integración.

  • Clave secreta de YooKassa: (por ejemplo, no configurada)

    • Qué es: una clave API secreta proporcionada por YooKassa que autentica las solicitudes del bot iSales AI a tu cuenta YooKassa. Mantén esta clave confidencial.
    • Cómo encontrarla: en tu cuenta personal de YooKassa, ve a los ajustes de integración, específicamente a la sección de claves API (a menudo etiquetada como “Integration” -> “API keys”). Genera o recupera tu clave secreta aquí.

❗ Requisito crucial: configuración del webhook

Importante antes de empezar: para que el bot iSales AI reciba información sobre facturas pagadas y actualice correctamente los estados de transacción, debes configurar un webhook de notificación HTTP en tu cuenta personal de YooKassa.

  • URL del webhook de YooKassa (proporcionada por iSales AI): https://api.isales.ai/payment/yookassa (o una URL única similar proporcionada en tu panel de iSales AI).

  • Cómo configurarlo en YooKassa:

    1. Inicia sesión en tu cuenta personal de YooKassa.
    2. Ve a la sección “Integration”.
    3. Busca “HTTP-notifications” (o una formulación similar para webhooks).
    4. Introduce la URL del webhook de YooKassa proporcionada por iSales AI en el campo correspondiente.
    5. Guarda los ajustes. Asegúrate de habilitar las notificaciones para pagos exitosos y otros eventos relevantes.

Configuración fiscal y de producto:

Ajusta el procesamiento de pagos a los requisitos fiscales de tu negocio:

  • IVA (impuesto sobre el valor añadido): (por ejemplo, without_vat) – Especifica el tipo de IVA aplicable a tus ventas. Las opciones suelen incluir:

    • Sin IVA (predeterminado/seleccionado en la captura)
    • IVA 0 %
    • IVA 10 %
    • IVA 20 %
    • Selecciona la opción que se ajuste a tus obligaciones fiscales.

  • Sistema fiscal: (por ejemplo, common_system) – Selecciona el sistema fiscal bajo el que opera tu negocio. Las opciones habituales pueden incluir:

    • IVA común / common_system (predeterminado/seleccionado en la captura)
    • IVA sobre ingresos
    • IVA ingresos-gastos
    • IVA patente
    • Elige el sistema aplicable a tu entidad jurídica en tu región.

  • Tipo de producto: (por ejemplo, product) – Define la naturaleza general de lo que vendes.

    • Producto (predeterminado/seleccionado en la captura): normalmente para bienes tangibles o elementos digitales distintos.
    • Servicio: para servicios prestados.

Gestión de tu integración de YooKassa:

La interfaz ofrece varios botones para configurar y gestionar la integración:

  • 🔑 Actualizar clave secreta de YooKassa (botón): haz clic para introducir o actualizar tu clave secreta de YooKassa.
  • 🆔 Actualizar ID de cuenta de YooKassa (botón): haz clic para introducir o actualizar tu ID de cuenta de YooKassa (shopId).
  • Procesamiento de YooKassa
    • 🟢 Activar / Desactivar (botones de alternancia): activa o desactiva YooKassa como método de pago.
  • IVA
    • Botones para Sin IVA, IVA 0 %, IVA 10 %, IVA 20 % para seleccionar el tipo de IVA adecuado.
  • Sistema fiscal
    • Botones para IVA común, IVA sobre ingresos, IVA ingresos-gastos, IVA patente para seleccionar tu sistema fiscal.
  • Tipo de producto
    • Botones para Producto y Servicio para definir el tipo de artículo predeterminado.
  • ↩️ Volver (botón): regresa al menú principal «Payment Processing for AI Bot».

Al introducir correctamente tus credenciales de YooKassa, configurar el webhook crucial y ajustar los detalles fiscales y del producto, puedes integrar YooKassa sin problemas con tu iSales AI Chatbot y ofrecer a tus clientes una experiencia de pago familiar y cómoda. Consulta siempre la documentación oficial de YooKassa para obtener la información más actualizada sobre ajustes y claves API.