common:getStarted

Pemrosesan Pembayaran YooKassa

Integrasi YooKassa: panduan pemrosesan pembayaran

Hubungkan iSales AI Chatbot Anda dengan YooKassa untuk menawarkan beragam metode pembayaran lokal yang populer di Rusia dan negara-negara CIS. Panduan ini akan membantu Anda mengonfigurasi integrasi YooKassa agar bot dapat memproses pembayaran untuk produk dan layanan Anda dengan lancar.

Status integrasi YooKassa:

  • Status YooKassa: (misalnya, 🟡 Mati / Tidak aktif) – Indikator ini menunjukkan apakah pemrosesan pembayaran YooKassa saat ini aktif atau tidak untuk chatbot AI Anda.

Pengaturan koneksi inti YooKassa:

Untuk menghubungkan iSales AI Chatbot Anda dengan akun YooKassa, Anda memerlukan kredensial berikut:

  • YooKassa Account ID: (misalnya, belum disetel)

    • Apa itu: pengenal unik untuk toko atau akun Anda di sistem YooKassa.
    • Cara menemukannya: masuk ke personal account YooKassa Anda (merchant dashboard). Account ID Anda (sering disebut shopId) akan tersedia di pengaturan akun atau detail integrasi.

  • YooKassa Secret Key: (misalnya, belum disetel)

    • Apa itu: secret API key yang disediakan YooKassa untuk mengautentikasi permintaan dari iSales AI Bot ke akun YooKassa Anda. Jaga kerahasiaan key ini.
    • Cara menemukannya: di personal account YooKassa Anda, buka pengaturan integrasi, khususnya bagian API keys (sering diberi label “Integration” -> “API keys”). Buat atau ambil secret key Anda di sini.

❗ Prasyarat penting: konfigurasi webhook

Penting sebelum memulai: agar iSales AI Bot dapat menerima informasi tentang invoice yang telah dibayar dan memperbarui status transaksi dengan benar, Anda harus menyiapkan webhook notifikasi HTTP di personal account YooKassa Anda.

  • YooKassa Webhook URL (disediakan oleh iSales AI): https://api.isales.ai/payment/yookassa (atau URL unik serupa yang disediakan di dashboard iSales AI Anda).

  • Cara menyiapkannya di YooKassa:

    1. Masuk ke personal account YooKassa Anda.
    2. Buka bagian “Integration”.
    3. Cari “HTTP-notifications” (atau istilah serupa untuk webhook).
    4. Masukkan YooKassa Webhook URL yang disediakan iSales AI ke kolom yang sesuai.
    5. Simpan pengaturan. Pastikan Anda mengaktifkan notifikasi untuk pembayaran berhasil dan event relevan lainnya.

Konfigurasi pajak dan produk:

Sesuaikan pemrosesan pembayaran dengan kebutuhan fiskal bisnis Anda:

  • VAT (Value Added Tax): (misalnya, without_vat) – Tentukan tarif VAT yang berlaku untuk penjualan Anda. Opsi biasanya meliputi:

    • Without VAT (default/dipilih pada tangkapan layar)
    • VAT 0%
    • VAT 10%
    • VAT 20%
    • Pilih opsi yang sesuai dengan kewajiban pajak Anda.

  • Tax System: (misalnya, common_system) – Pilih sistem pajak yang digunakan bisnis Anda. Opsi umum dapat mencakup:

    • Common VAT / common_system (default/dipilih pada tangkapan layar)
    • Income VAT
    • Income-Expense VAT
    • Patent VAT
    • Pilih sistem yang berlaku untuk badan hukum Anda di wilayah Anda.

  • Product Type: (misalnya, product) – Tentukan sifat umum dari apa yang Anda jual.

    • Product (default/dipilih pada tangkapan layar): biasanya untuk barang berwujud atau item digital yang terpisah.
    • Service: untuk layanan yang diberikan.

Mengelola integrasi YooKassa Anda:

Antarmuka menyediakan beberapa tombol untuk mengonfigurasi dan mengelola integrasi:

  • 🔑 Update YooKassa Secret Key (Button): klik untuk memasukkan atau memperbarui YooKassa Secret Key Anda.
  • 🆔 Update YooKassa Account ID (Button): klik untuk memasukkan atau memperbarui YooKassa Account ID Anda (shopId).
  • YooKassa Processing
    • 🟢 Enable / Disable (Toggle Buttons): mengaktifkan atau menonaktifkan YooKassa sebagai metode pembayaran.
  • VAT
    • Tombol untuk Without VAT, VAT 0%, VAT 10%, VAT 20% guna memilih tarif VAT yang sesuai.
  • Tax System
    • Tombol untuk Common VAT, Income VAT, Income-Expense VAT, Patent VAT guna memilih sistem pajak Anda.
  • Product Type
    • Tombol untuk Product dan Service guna menentukan jenis item default.
  • ↩️ Back (Button): kembali ke menu utama “Payment Processing for AI Bot”.

Dengan memasukkan kredensial YooKassa dengan benar, menyiapkan webhook penting, dan mengonfigurasi detail pajak serta produk, Anda dapat mengintegrasikan YooKassa dengan mulus ke iSales AI Chatbot Anda dan memberikan pengalaman pembayaran yang familiar dan nyaman kepada pelanggan. Selalu rujuk dokumentasi resmi YooKassa untuk informasi paling mutakhir tentang pengaturan dan API keys.