Get Started

YooKassa Ödeme İşleme

YooKassa entegrasyonu: ödeme işleme kılavuzu

iSales AI Chatbot'unuzu YooKassa ile bağlayarak Rusya ve BDT ülkelerinde popüler olan yerelleştirilmiş ödeme yöntemlerinin geniş bir yelpazesini sunun. Bu kılavuz, YooKassa entegrasyonunu yapılandırmanıza yardımcı olur; böylece botunuz ürün ve hizmetlerinizin ödemelerini sorunsuz şekilde işleyebilir.

YooKassa entegrasyon durumu:

  • YooKassa durumu: (örn. 🟡 Kapalı / Etkin değil) – Bu gösterge, YooKassa ödeme işlemenin AI chatbot'unuz için şu anda etkin olup olmadığını gösterir.

YooKassa bağlantı için temel ayarlar:

iSales AI Chatbot'unuzu YooKassa hesabınıza bağlamak için aşağıdaki kimlik bilgilerine ihtiyacınız olacak:

  • YooKassa Account ID: (örn. Ayarlanmadı)

    • Nedir: YooKassa sistemindeki mağaza veya hesabınız için benzersiz tanımlayıcı.
    • Nasıl bulunur: YooKassa personal account'unuza (merchant dashboard) giriş yapın. Account ID'niz (çoğu zaman shopId olarak adlandırılır) hesabınızın ayarlarında veya entegrasyon ayrıntılarında bulunur.

  • YooKassa Secret Key: (örn. Ayarlanmadı)

    • Nedir: iSales AI Bot'tan YooKassa hesabınıza gelen istekleri doğrulayan, YooKassa tarafından sağlanan gizli bir API key'dir. Bu key'i gizli tutun.
    • Nasıl bulunur: YooKassa personal account'unuzda entegrasyon ayarlarına, özellikle API keys bölümüne gidin (çoğu zaman “Integration” -> “API keys” olarak etiketlenir). Gizli anahtarınızı burada oluşturun veya alın.

❗ Kritik ön koşul: webhook yapılandırması

Başlamadan önce önemli: iSales AI Bot'un paid invoices bilgilerini alabilmesi ve transaction status'larını doğru şekilde güncelleyebilmesi için, YooKassa personal account'unuzda bir HTTP notification webhook kurmanız zorunludur.

  • YooKassa Webhook URL (iSales AI tarafından sağlanır): https://api.isales.ai/payment/yookassa (veya iSales AI dashboard'unuzda sağlanan benzer benzersiz bir URL).

  • Bunu YooKassa'da nasıl kurarsınız:

    1. YooKassa personal account'unuza giriş yapın.
    2. “Integration” bölümüne gidin.
    3. “HTTP-notifications” (veya webhooks için benzer bir ifade) bulun.
    4. iSales AI tarafından sağlanan YooKassa Webhook URL'yi ilgili alana girin.
    5. Ayarları kaydedin. Başarılı ödemeler ve diğer ilgili olaylar için bildirimleri etkinleştirdiğinizden emin olun.

Vergi ve ürün yapılandırması:

Ödeme işlemesini işletmenizin mali gereksinimlerine göre uyarlayın:

  • VAT (Value Added Tax): (örn. without_vat) – Satışlarınıza uygulanacak VAT rate'i belirtin. Seçenekler genellikle şunlardır:

    • Without VAT (varsayılan/ekranda seçili)
    • VAT 0%
    • VAT 10%
    • VAT 20%
    • Vergi yükümlülüklerinize uygun seçeneği belirleyin.

  • Tax System: (örn. common_system) – İşletmenizin faaliyet gösterdiği tax system'i seçin. Yaygın seçenekler şunları içerebilir:

    • Common VAT / common_system (varsayılan/ekranda seçili)
    • Income VAT
    • Income-Expense VAT
    • Patent VAT
    • Bölgenizdeki yasal varlığınıza uygun sistemi seçin.

  • Product Type: (örn. product) – Sattığınız şeyin genel niteliğini tanımlayın.

    • Product (varsayılan/ekranda seçili): genellikle somut mallar veya ayrı dijital öğeler için.
    • Service: sunulan hizmetler için.

YooKassa entegrasyonunuzu yönetme:

Arayüz, entegrasyonu yapılandırmak ve yönetmek için birkaç düğme sunar:

  • 🔑 Update YooKassa Secret Key (Button): YooKassa Secret Key'inizi girmek veya güncellemek için tıklayın.
  • 🆔 Update YooKassa Account ID (Button): YooKassa Account ID'nizi (shopId) girmek veya güncellemek için tıklayın.
  • YooKassa Processing
    • 🟢 Enable / Disable (Toggle Buttons): YooKassa'yı bir payment method olarak etkinleştirir veya devre dışı bırakır.
  • VAT
    • Uygun VAT rate'i seçmek için Without VAT, VAT 0%, VAT 10%, VAT 20% düğmeleri.
  • Tax System
    • tax system'inizi seçmek için Common VAT, Income VAT, Income-Expense VAT, Patent VAT düğmeleri.
  • Product Type
    • varsayılan item type'ı tanımlamak için Product ve Service düğmeleri.
  • ↩️ Back (Button): ana “Payment Processing for AI Bot” menüsüne döner.

YooKassa kimlik bilgilerinizi doğru girerek, kritik webhook'u kurarak ve vergi ile ürün ayrıntılarını yapılandırarak YooKassa'yı iSales AI Chatbot'unuzla sorunsuz biçimde entegre edebilir ve müşterilerinize tanıdık, kullanışlı bir ödeme deneyimi sunabilirsiniz. Ayarlar ve API keys hakkında en güncel bilgiler için her zaman YooKassa'nın resmi belgelerine başvurun.