iSales AI

YooKassa Payment Processing

Integrating YooKassa: Payment Processing Guide

Connect your iSales AI Chatbot with YooKassa to offer a wide range of localized payment methods popular in Russia and CIS countries. This guide will help you configure the YooKassa integration, enabling your bot to process payments for your products and services seamlessly.

YooKassa Integration Status:

  • YooKassa Status: (e.g., 🟡 Off / Inactive) – This indicator shows whether YooKassa payment processing is currently enabled or disabled for your AI chatbot.

Core YooKassa Connection Settings:

To link your iSales AI Chatbot with your YooKassa account, you’ll need the following credentials:

  • YooKassa Account ID: (e.g., Not set)
    • What it is: Your unique identifier for your shop or account within the YooKassa system.
    • How to find it: Log in to your YooKassa personal account (merchant dashboard). Your Account ID (often referred to as shopId) will be available in your account settings or integration details.
  • YooKassa Secret Key: (e.g., Not set)
    • What it is: A secret API key provided by YooKassa that authenticates requests from the iSales AI Bot to your YooKassa account. Keep this key confidential.
    • How to find it: In your YooKassa personal account, navigate to the integration settings, specifically the section for API keys (often labeled “Integration” -> “API keys”). Generate or retrieve your secret key here.

❗ Crucial Prerequisite: Webhook Configuration

Important Before Starting: For the iSales AI Bot to receive information about paid invoices and update transaction statuses correctly, you must set up an HTTP notification webhook in your YooKassa personal account.

  • YooKassa Webhook URL (Provided by iSales AI): https://api.isales.ai/payment/yookassa (or a similar unique URL provided within your iSales AI dashboard).
  • How to set it up in YooKassa:
    1. Log in to your YooKassa personal account.
    2. Go to the “Integration” section.
    3. Find “HTTP-notifications” (or similar wording for webhooks).
    4. Enter the YooKassa Webhook URL provided by iSales AI into the appropriate field.
    5. Save the settings. Ensure you enable notifications for successful payments and other relevant events.

Tax and Product Configuration:

Tailor the payment processing to match your business’s fiscal requirements:

  • VAT (Value Added Tax): (e.g., without_vat) – Specify the VAT rate applicable to your sales. Options typically include:
    • Without VAT (Default/Selected in screenshot)
    • VAT 0%
    • VAT 10%
    • VAT 20%
    • Select the option that aligns with your tax obligations.
  • Tax System: (e.g., common_system) – Select the tax system under which your business operates. Common options might include:
    • Common VAT / common_system (Default/Selected in screenshot)
    • Income VAT
    • Income-Expense VAT
    • Patent VAT
    • Choose the system applicable to your legal entity in your region.
  • Product Type: (e.g., product) – Define the general nature of what you are selling.
    • Product (Default/Selected in screenshot): Typically for tangible goods or distinct digital items.
    • Service: For services rendered.

Managing Your YooKassa Integration:

The interface provides several buttons to configure and manage the integration:

  • 🔑 Update YooKassa Secret Key (Button): Click to enter or update your YooKassa Secret Key.
  • 🆔 Update YooKassa Account ID (Button): Click to enter or update your YooKassa Account ID (shopId).
  • ——| YooKassa Processing |——
    • 🟢 Enable / Disable (Toggle Buttons): Activates or deactivates YooKassa as a payment method.
  • ——| VAT |——
    • Buttons for Without VAT, VAT 0%, VAT 10%, VAT 20% to select the appropriate VAT rate.
  • ——| Tax System |——
    • Buttons for Common VAT, Income VAT, Income-Expense VAT, Patent VAT to select your tax system.
  • ——| Product Type |——
    • Buttons for Product and Service to define the default item type.
  • ↩️ Back (Button): Returns to the main “Payment Processing for AI Bot” menu.

By correctly inputting your YooKassa credentials, setting up the crucial webhook, and configuring the tax and product details, you can seamlessly integrate YooKassa with your iSales AI Chatbot, offering your customers a familiar and convenient payment experience. Always refer to YooKassa’s official documentation for the most up-to-date information on their settings and API keys.