Hướng dẫn lấy Secret Key và kết nối Stripe
Để kích hoạt hệ thống thanh toán tự động, bạn cần kết nối tài khoản Stripe của mình với portal thông qua khóa bí mật.Lấy Secret Key từ tài khoản Stripe
Để lấy khóa kết nối, thực hiện theo quy trình sau:
- Đăng nhập vào trang quản trị Stripe của bạn.
- Di chuyển đến mục Developers ở góc trên bên phải, sau đó chọn tab API keys.
- Tại khu vực Standard keys, tìm khóa có tên là Secret key.
- Nhấn nút để hiển thị khóa và sao chép toàn bộ chuỗi ký tự (chuỗi này bắt đầu bằng tiền tố
sk_live_đối với môi trường hoạt động thực tế hoặcsk_test_đối với môi trường thử nghiệm).
Mở trang cấu hình cổng thanh toán
Đăng nhập vào Portal quản trị, tìm mục SaaS ở menu điều hướng bên trái và chọn Payment Processor.
Nhập khóa và kích hoạt kết nối
- Dán chuỗi ký tự vừa sao chép vào trường Secret key trên giao diện Payment Processor.
- Nhấn nút Save configuration để hoàn tất kết nối.
Tạo Product và mức giá định kỳ trong Stripe
Để bán gói dịch vụ, bạn cần tạo sản phẩm và cấu hình giá tương ứng trên tài khoản Stripe của mình:Mở giao diện Product catalog
Tại trang quản trị Stripe, mở menu Product catalog ở thanh bên trái và nhấn nút + Create product ở góc trên bên phải.
Nhập thông tin sản phẩm và cấu hình giá cơ bản
Tại biểu mẫu Add a product, điền các thông tin sau:
- Name (required): Tên gói dịch vụ.
- Description: Mô tả ngắn gọn về gói dịch vụ.
- Pricing: Chọn Recurring để cấu hình thanh toán định kỳ theo chu kỳ. Nhập số tiền tại ô Amount và chọn đơn vị tiền tệ tương ứng.
Thiết lập chu kỳ thanh toán (Billing period)
Tại ô Billing period, chọn chu kỳ thanh toán mong muốn trong danh sách lựa chọn (như Monthly để thu phí hàng tháng hoặc Yearly để thu phí hàng năm).
Lựa chọn mô hình tính phí phù hợp
Tại mục cấu hình nâng cao của giá sản phẩm, di chuyển tới phần Choose your pricing model để chọn phương án tính phí:
- Flat rate: Áp dụng một mức giá cố định cho toàn bộ gói.
- Tiered pricing: Tính phí theo mốc số lượng sử dụng tài nguyên.
- Usage-based: Tính phí dựa trên mức độ sử dụng thực tế của khách hàng.
Cấu hình mô hình tính phí bổ sung
- Nếu bạn chọn Tiered pricing, hãy chọn cách thức tính phí theo mốc:
- Volume: Đơn giá của tất cả các đơn vị được tính theo mốc cuối cùng đạt được (tương ứng với mô hình Volume pricing mà portal hỗ trợ).
- Graduated: Phí được tính lũy tiến cộng dồn qua từng mốc số lượng.
- Nếu bạn chọn Usage-based, hãy chọn cách thức đo lường:
- Per unit: Tính phí theo số lượng người dùng hoặc số lượng đơn vị sử dụng.
- Per package: Tính phí theo từng gói đơn vị.
- Per tier: Tính phí theo mốc số lượng sử dụng.
Thiết lập bộ đo lường sử dụng (Meter)
Đối với mô hình Usage-based, bạn cần khai báo bộ đo lường:
- Meter: Chọn bộ đo lường phù hợp trong ô Choose a meter hoặc bấm nút + Create meter để tạo mới bộ theo dõi dữ liệu sử dụng của khách hàng.
- Billing period: Chọn chu kỳ thanh toán (thông thường là Monthly).
- Lookup key: Nhập khóa tra cứu duy nhất tại phần Advanced (ví dụ:
standard_monthly) để dễ dàng quản lý giá qua hệ thống.
Hướng dẫn lấy Price ID từ Stripe
Sau khi sản phẩm đã được tạo thành công trên Stripe, bạn thực hiện lấy mã định danh giá (Price ID) để liên kết vào portal của mình. Chọn tùy chọn Copy price ID hiển thị ở đầu menu thả xuống. Mã định danh giá có định dạng bắt đầu bằng tiền tốprice_
Các bước tiếp theo
Sau khi đã lấy được Price ID từ Stripe, bạn cần quay lại Portal quản trị để thực hiện cấu hình hạn mức tài nguyên và dán mã liên kết giá này vào gói dịch vụ tương ứng. Vui lòng thực hiện theo hướng dẫn chi tiết tại bài viết Cấu hình và Quản lý các gói dịch vụ trên ChatbotX White Label để hoàn tất việc thiết lập Plans cho khách hàng.Trước khi đưa cổng thanh toán vào vận hành chính thức, hãy thực hiện kiểm thử toàn bộ luồng thanh toán bằng cách sử dụng các thẻ thử nghiệm trong môi trường Test Mode của Stripe để đảm bảo hóa đơn và hạn mức tài nguyên hoạt động chuẩn xác.