common:getStarted

Xử lý thanh toán YooKassa

Tích hợp YooKassa: hướng dẫn xử lý thanh toán

Kết nối iSales AI Chatbot của bạn với YooKassa để cung cấp nhiều phương thức thanh toán bản địa hóa phổ biến tại Nga và các nước CIS. Hướng dẫn này sẽ giúp bạn cấu hình tích hợp YooKassa để bot có thể xử lý thanh toán cho sản phẩm và dịch vụ của bạn một cách trơn tru.

Trạng thái tích hợp YooKassa:

  • Trạng thái YooKassa: (ví dụ, 🟡 Tắt / Không hoạt động) – Chỉ báo này cho biết việc xử lý thanh toán YooKassa hiện đang bật hay tắt đối với chatbot AI của bạn.

Cài đặt kết nối cốt lõi của YooKassa:

Để liên kết iSales AI Chatbot của bạn với tài khoản YooKassa, bạn sẽ cần các thông tin xác thực sau:

  • YooKassa Account ID: (ví dụ, chưa thiết lập)

    • Là gì: mã định danh duy nhất cho cửa hàng hoặc tài khoản của bạn trong hệ thống YooKassa.
    • Cách tìm: đăng nhập vào personal account YooKassa của bạn (merchant dashboard). Account ID của bạn (thường được gọi là shopId) sẽ có trong phần cài đặt tài khoản hoặc chi tiết tích hợp.

  • YooKassa Secret Key: (ví dụ, chưa thiết lập)

    • Là gì: secret API key do YooKassa cung cấp để xác thực các yêu cầu từ iSales AI Bot tới tài khoản YooKassa của bạn. Hãy giữ bí mật key này.
    • Cách tìm: trong personal account YooKassa của bạn, hãy vào cài đặt tích hợp, cụ thể là phần API keys (thường được gắn nhãn “Integration” -> “API keys”). Tạo hoặc lấy secret key của bạn tại đây.

❗ Điều kiện tiên quyết quan trọng: cấu hình webhook

Quan trọng trước khi bắt đầu: để iSales AI Bot nhận được thông tin về các hóa đơn đã thanh toán và cập nhật trạng thái giao dịch chính xác, bạn bắt buộc phải thiết lập webhook thông báo HTTP trong personal account YooKassa của mình.

  • YooKassa Webhook URL (do iSales AI cung cấp): https://api.isales.ai/payment/yookassa (hoặc một URL duy nhất tương tự được cung cấp trong dashboard iSales AI của bạn).

  • Cách thiết lập trong YooKassa:

    1. Đăng nhập vào personal account YooKassa của bạn.
    2. Vào mục “Integration”.
    3. Tìm “HTTP-notifications” (hoặc cách gọi tương tự cho webhook).
    4. Nhập YooKassa Webhook URL do iSales AI cung cấp vào trường phù hợp.
    5. Lưu cài đặt. Hãy đảm bảo bật thông báo cho thanh toán thành công và các sự kiện liên quan khác.

Cấu hình thuế và sản phẩm:

Điều chỉnh xử lý thanh toán cho phù hợp với yêu cầu tài chính của doanh nghiệp bạn:

  • VAT (Value Added Tax): (ví dụ, without_vat) – Chỉ định mức VAT áp dụng cho doanh số của bạn. Các tùy chọn thường bao gồm:

    • Without VAT (mặc định/được chọn trong ảnh chụp)
    • VAT 0%
    • VAT 10%
    • VAT 20%
    • Chọn tùy chọn phù hợp với nghĩa vụ thuế của bạn.

  • Tax System: (ví dụ, common_system) – Chọn hệ thống thuế mà doanh nghiệp bạn đang áp dụng. Các tùy chọn phổ biến có thể gồm:

    • Common VAT / common_system (mặc định/được chọn trong ảnh chụp)
    • Income VAT
    • Income-Expense VAT
    • Patent VAT
    • Chọn hệ thống áp dụng cho pháp nhân của bạn tại khu vực của bạn.

  • Product Type: (ví dụ, product) – Xác định bản chất chung của thứ bạn đang bán.

    • Product (mặc định/được chọn trong ảnh chụp): thường dành cho hàng hóa hữu hình hoặc các mặt hàng kỹ thuật số riêng biệt.
    • Service: dành cho các dịch vụ được cung cấp.

Quản lý tích hợp YooKassa của bạn:

Giao diện cung cấp một số nút để cấu hình và quản lý tích hợp:

  • 🔑 Update YooKassa Secret Key (Button): nhấp để nhập hoặc cập nhật YooKassa Secret Key của bạn.
  • 🆔 Update YooKassa Account ID (Button): nhấp để nhập hoặc cập nhật YooKassa Account ID (shopId) của bạn.
  • YooKassa Processing
    • 🟢 Enable / Disable (Toggle Buttons): bật hoặc tắt YooKassa như một phương thức thanh toán.
  • VAT
    • Các nút cho Without VAT, VAT 0%, VAT 10%, VAT 20% để chọn mức VAT phù hợp.
  • Tax System
    • Các nút cho Common VAT, Income VAT, Income-Expense VAT, Patent VAT để chọn hệ thống thuế của bạn.
  • Product Type
    • Các nút cho Product và Service để xác định loại mặt hàng mặc định.
  • ↩️ Back (Button): quay về menu chính “Payment Processing for AI Bot”.

Bằng cách nhập đúng thông tin xác thực YooKassa, thiết lập webhook quan trọng và cấu hình chi tiết thuế cũng như sản phẩm, bạn có thể tích hợp YooKassa một cách liền mạch với iSales AI Chatbot của mình và mang đến cho khách hàng trải nghiệm thanh toán quen thuộc, tiện lợi. Hãy luôn tham khảo tài liệu chính thức của YooKassa để có thông tin cập nhật nhất về cài đặt và API keys.