Cài đặt thanh toán

Mô-đun Cài đặt thanh toán cho phép bạn tích hợp hoàn toàn Kuee với Stripe — hỗ trợ thanh toán thẻ, quản lý thiết bị POS và quyết toán tự động. Hướng dẫn này bao gồm cả bốn tab: Cài đặt tài khoản, Thiết bị POS, Giao dịch và Cài đặt nâng cao.

Truy cập cài đặt thanh toán

Ở thanh bên trái, nhấp Cài đặt hệ thống > Cài đặt cơ bản, sau đó chọn tab Cài đặt thanh toán ở trên cùng.

Cài đặt thanh toán gồm bốn tab:

Cài đặt tài khoản

Chưa kết nối: Kết nối tài khoản Stripe

Khi sử dụng lần đầu, tab Cài đặt tài khoản hiển thị màn hình giới thiệu Kết nối tài khoản Stripe:

• Connect Stripe — Chuyển hướng đến quy trình Stripe Connect để tạo hoặc liên kết tài khoản Stripe Express
• Đã có tài khoản? Nhấp vào đây — Nếu bạn đã có tài khoản Stripe Express, liên kết này sẽ tự động tìm và đồng bộ

Các bước kết nối Stripe:

1. Nhấp Connect Stripe trên tab Cài đặt tài khoản
2. Hoàn thành biểu mẫu đăng ký Stripe (tên doanh nghiệp, tài khoản ngân hàng, xác minh danh tính, v.v.)
3. Gửi tất cả các bước — Stripe xem xét và tự động chuyển hướng bạn về Kuee
4. Khi quay lại, tab Cài đặt tài khoản hiển thị thẻ trạng thái màu xanh "Tài khoản đã kết nối"

Mẹo: Nếu bạn đã có tài khoản Stripe Express, sử dụng "Đã có tài khoản? Nhấp vào đây" để đồng bộ tự động — không cần đăng ký lại.

Đăng ký chưa hoàn tất

Nếu bạn đã bắt đầu nhưng chưa hoàn tất quy trình Stripe Connect (ví dụ: đóng trình duyệt giữa chừng), hệ thống hiển thị biểu ngữ cảnh báo màu vàng.

Các hành động có sẵn:

Lưu ý: Thanh toán thẻ và Stripe Terminal không thể sử dụng cho đến khi quá trình đăng ký hoàn tất đầy đủ.

Tài khoản đã kết nối

Khi kết nối thành công, trang hiển thị thẻ trạng thái tài khoản màu xanh:

Các hành động có sẵn:

• Mở bảng điều khiển — Tạo liên kết dùng một lần để mở Bảng điều khiển Stripe Express trong tab mới (xem khoản thanh toán, số dư, v.v.)
• Kết nối lại — Làm mới trạng thái kết nối tài khoản

Thiết bị POS

Tab Thiết bị POS quản lý các đầu đọc thẻ vật lý, hỗ trợ thanh toán chip, dải từ và không tiếp xúc (NFC).

Thiết lập đầu đọc lần đầu (Hướng dẫn từng bước)

Sau khi nhận được đầu đọc thẻ, hãy làm theo các bước sau để thiết lập từ mở hộp đến nhận thanh toán:

Bước 1: Mở hộp & Bật nguồn

1. Lấy đầu đọc và cáp nguồn ra khỏi hộp
2. Cắm cáp nguồn và kết nối với ổ điện
3. Nhấn nút nguồn để khởi động thiết bị (khởi động lần đầu có thể mất 1–2 phút)
4. Thiết bị sẽ tự động kiểm tra và cài đặt cập nhật firmware (nếu có, vui lòng đợi hoàn tất)

Bước 2: Kết nối Wi-Fi

1. Trên màn hình cảm ứng của đầu đọc, vào Cài đặt (Settings)
2. Chọn Wi-Fi hoặc Mạng (Network)
3. Chọn mạng Wi-Fi của cửa hàng từ danh sách
4. Nhập mật khẩu Wi-Fi và nhấn Kết nối (Connect)
5. Xác nhận biểu tượng Wi-Fi xuất hiện ở đầu màn hình

Quan trọng: Đầu đọc phải kết nối mạng Wi-Fi ổn định để hoạt động. Sử dụng mạng chuyên dụng của cửa hàng thay vì điểm phát sóng công cộng.

Bước 3: Lấy mã đăng ký

Mã đăng ký liên kết thiết bị vật lý với tài khoản Kuee của bạn. Cách lấy phụ thuộc vào mẫu đầu đọc:

WisePOS E:

1. Trên màn hình chính của đầu đọc, nhập dãy phím 0-7-1-3-9
2. Màn hình sẽ hiển thị mã đăng ký duy nhất (định dạng như clever-word-phrase)

Stripe Reader S700 / S710:

1. Trên màn hình cảm ứng đầu đọc, vào Cài đặt (Settings)
2. Nhấn Tạo mã ghép nối (Generate Pairing Code)
3. Màn hình sẽ hiển thị mã đăng ký duy nhất

Mẹo: Mã đăng ký hết hạn sau một thời gian ngắn. Hoàn thành bước tiếp theo ngay sau khi tạo mã.

Bước 4: Đăng ký đầu đọc trong Kuee

1. Trong Kuee, vào Cài đặt hệ thống > Cài đặt cơ bản > Cài đặt thanh toán
2. Chuyển sang tab Thiết bị POS
3. Nhấp nút Thêm đầu đọc thẻ
4. Nhập Mã đăng ký từ Bước 3 vào hộp thoại
5. Nhập Tên đầu đọc dễ nhận biết (ví dụ: "Quầy lễ tân 1", "Đầu đọc phòng")
6. Nhấp Thêm đầu đọc thẻ để hoàn tất đăng ký

Bước 5: Xác nhận kết nối & Kiểm tra

1. Sau khi đăng ký, xác nhận thiết bị hiển thị trạng thái Trực tuyến trong danh sách
2. Nên thực hiện một giao dịch thử nhỏ để xác minh đầu đọc hoạt động bình thường
3. Nếu trạng thái hiển thị "Ngoại tuyến", kiểm tra kết nối Wi-Fi của đầu đọc và nhấp Đồng bộ từ Stripe để làm mới

Hoàn tất! Đầu đọc đã sẵn sàng. Bạn có thể chọn "Thanh toán thẻ" khi thanh toán để sử dụng đầu đọc thu tiền.

Danh sách đầu đọc

Thêm đầu đọc

Nhấp Thêm đầu đọc ở góc trên bên phải:

1. Tìm Mã đăng ký trên màn hình đầu đọc vật lý hoặc trong Bảng điều khiển Stripe
2. Trong hộp thoại, điền:
   • Mã đăng ký (bắt buộc)
   • Nhãn đầu đọc (tùy chọn, ví dụ: "Đầu đọc lễ tân")
3. Nhấp Thêm đầu đọc để hoàn tất đăng ký

Mẹo: Mỗi đầu đọc vật lý có một mã đăng ký duy nhất. Đăng ký một lần để liên kết vĩnh viễn với cửa hàng.

Đồng bộ từ Stripe

Nhấp Đồng bộ từ Stripe để tự động lấy trạng thái đầu đọc mới nhất từ Stripe:

• Thiết bị mới → Thêm vào danh sách
• Thiết bị đã xóa → Xóa khỏi danh sách
• Thay đổi trạng thái (trực tuyến/ngoại tuyến) → Tự động cập nhật

Giao dịch

Tab Giao dịch hiển thị tất cả các khoản thanh toán thẻ được xử lý qua đầu đọc Stripe Terminal.

Thẻ tóm tắt

Bốn chỉ số chính được hiển thị ở trên cùng cho khoảng thời gian đã chọn:

Xem và lọc

• Khoảng thời gian — Mặc định là 7 ngày gần nhất; nhấp để chọn khoảng tùy chỉnh
• Tìm kiếm — Nhập từ khóa để tìm giao dịch cụ thể
• Xuất — Tải xuống dữ liệu giao dịch

Trạng thái giao dịch

Lưu ý: Tab Giao dịch chỉ hiển thị các khoản thanh toán thu qua đầu đọc Stripe Terminal. Đối với thanh toán tiền mặt và thẻ nhập thủ công, xem mô-đun Quản lý đơn hàng.

Cài đặt nâng cao

Tab Cài đặt nâng cao cung cấp cấu hình tiền tip cho đầu đọc thẻ.

Cấu hình tiền tip

Khi được bật, khách hàng sẽ thấy tùy chọn tiền tip trên màn hình đầu đọc thẻ khi thanh toán.

Các bước cấu hình:

1. Bật nút Kích hoạt tiền tip đầu đọc
2. Đặt ba tùy chọn Phần trăm tiền tip có sẵn (ví dụ: 15%, 18%, 20%)
3. Nhấp Lưu cấu hình

Lưu ý:

• Ba tùy chọn phần trăm phải là duy nhất và nằm trong khoảng 1–100
• Ngoài các tùy chọn có sẵn, khách hàng có thể chọn "Số tiền tùy chỉnh" để nhập bất kỳ số tiền tip nào
• Sau khi lưu, cấu hình áp dụng cho tất cả đầu đọc đã kết nối trong vòng vài phút

Thiết lập tài khoản Stripe

Kuee sử dụng tài khoản Stripe Express — một loại tài khoản Stripe đặc biệt được quản lý thông qua nền tảng của chúng tôi. Bạn không cần tự tạo tài khoản Stripe tại stripe.com. Thay vào đó, toàn bộ quá trình thiết lập được xử lý thông qua Cài đặt thanh toán của Kuee.

Tài khoản Stripe Express là gì?

Tài khoản Stripe Express khác với tài khoản Stripe thông thường:

Các bước thiết lập

1. Trong Kuee, đi đến Cài đặt hệ thống > Cài đặt cơ bản > Cài đặt thanh toán
2. Trên tab Cài đặt tài khoản, nhấp Connect Stripe
3. Bạn sẽ được chuyển hướng đến biểu mẫu đăng ký do Stripe lưu trữ, nơi bạn cần cung cấp:
   • Loại hình kinh doanh: Cá nhân, doanh nghiệp tư nhân hoặc công ty
   • Chi tiết kinh doanh: Tên doanh nghiệp, địa chỉ, số điện thoại và ngành nghề
   • Thông tin cá nhân: Tên người chịu trách nhiệm, ngày sinh và 4 số cuối SSN (hoặc EIN đầy đủ)
   • Tài khoản ngân hàng: Số định tuyến và số tài khoản để nhận thanh toán
4. Hoàn thành tất cả các bước và nhấp Gửi
5. Stripe xem xét thông tin và tự động chuyển hướng bạn về Kuee
6. Khi quay lại, tab Cài đặt tài khoản hiển thị trạng thái "Tài khoản đã kết nối" màu xanh

Thời gian xem xét

• Hầu hết tài khoản được phê duyệt ngay lập tức khi gửi
• Trong một số trường hợp, Stripe có thể yêu cầu tài liệu bổ sung, mất 1–2 ngày làm việc để xem xét
• Bạn sẽ nhận được thông báo email từ Stripe trong quá trình xem xét

Nếu bạn đã có tài khoản Stripe Express

Nếu bạn đã tạo tài khoản Stripe Express qua nền tảng khác trước đó, nhấp "Đã có tài khoản? Nhấp vào đây" trên tab Cài đặt tài khoản. Kuee sẽ tự động tìm và đồng bộ tài khoản hiện có — không cần đăng ký lại.

Mẹo: Chuẩn bị sẵn giấy phép kinh doanh (nếu có), EIN hoặc SSN và thông tin tài khoản ngân hàng trước khi bắt đầu — điều này giúp đẩy nhanh quá trình đăng ký.

Mua đầu đọc thẻ

Để chấp nhận thanh toán thẻ trực tiếp tại phòng khám, bạn cần mua đầu đọc thẻ được Stripe chứng nhận.

Cách mua

Vì Kuee sử dụng tài khoản Stripe Express, đầu đọc không thể mua trực tiếp từ Bảng điều khiển Stripe. Thay vào đó, mua qua Cửa hàng đầu đọc Kuee:

Cửa hàng đầu đọc Kuee — Sắp ra mắt

Chúng tôi đang xây dựng cửa hàng đầu đọc chuyên dụng trong Kuee, nơi bạn có thể duyệt, đặt hàng và theo dõi đầu đọc thẻ được Stripe chứng nhận trực tiếp. Cửa hàng sẽ hỗ trợ tất cả các mẫu đầu đọc thông minh tương thích và giao hàng đến địa chỉ tại Mỹ.

Trong thời gian chờ đợi, vui lòng liên hệ đội ngũ hỗ trợ qua Trợ lý AI Kuee trong ứng dụng (góc dưới bên phải) để sắp xếp mua đầu đọc. Chúng tôi sẽ giúp bạn chọn mẫu phù hợp và xử lý đơn hàng thay bạn.

Các mẫu đầu đọc được hỗ trợ

Kuee sử dụng tích hợp phía máy chủ (server-driven) của Stripe, có nghĩa là chỉ đầu đọc thông minh kết nối trực tiếp với internet mới được hỗ trợ. Đầu đọc di động (như Stripe M2) yêu cầu ghép nối Bluetooth với điện thoại không tương thích với Kuee.

Quan trọng: Đầu đọc Stripe M2 là thiết bị di động/Bluetooth chỉ hoạt động với SDK di động của Stripe. Nó không được hỗ trợ bởi hệ thống thanh toán phía máy chủ của Kuee. Vui lòng chọn một trong các đầu đọc thông minh được liệt kê ở trên.

Vận chuyển và cài đặt

• Vận chuyển nội địa Mỹ thường mất 3–5 ngày làm việc
• Sau khi nhận thiết bị, bật nguồn, kết nối Wi-Fi, sau đó sử dụng mã đăng ký trong tab Thiết bị POS của Kuee để hoàn tất liên kết

Mẹo: Cân nhắc giữ một đầu đọc dự phòng để tránh gián đoạn nếu thiết bị gặp sự cố.

Phí xử lý thanh toán

Hiểu cấu trúc phí giúp bạn lập kế hoạch chi phí thanh toán của phòng khám tốt hơn. Tất cả phí bao gồm xử lý thanh toán và dịch vụ nền tảng — một mức giá duy nhất, minh bạch, không có phí ẩn.

Tổng quan phí

Chi tiết phí

• Không phí hàng tháng: Không có phí đăng ký hàng tháng cho xử lý thanh toán
• Không phí cài đặt: Tạo tài khoản và kết nối hoàn toàn miễn phí
• Không phí ẩn: Phí chỉ phát sinh khi có giao dịch xảy ra
• Giá đơn giản, trọn gói: Các mức phí trên bao gồm tất cả phí xử lý thanh toán và dịch vụ nền tảng — bạn thấy bao nhiêu thì trả bấy nhiêu

Ví dụ phí

Mẹo: Đối với hầu hết phòng khám, thanh toán thẻ trực tiếp (2,8% + 5¢) là loại giao dịch phổ biến nhất và có mức phí thấp nhất. Khuyến khích khách hàng sử dụng đầu đọc thẻ bất cứ khi nào có thể để được mức phí tốt nhất.

Xử lý sự cố và câu hỏi thường gặp

Sự cố đầu đọc

Sự cố thanh toán

Sự cố tài khoản

Mẹo: Nếu các giải pháp trên không giải quyết được vấn đề, liên hệ đội ngũ hỗ trợ qua tính năng dịch vụ khách hàng trong ứng dụng Kuee.

Các phương pháp tốt nhất

Thiết lập tài khoản Stripe Express:

• Chuẩn bị giấy phép kinh doanh, EIN/SSN và thông tin tài khoản ngân hàng trước khi nhấp "Connect Stripe" — điều này giúp đẩy nhanh quá trình đăng ký
• Sử dụng cùng tên doanh nghiệp trên giấy phép kinh doanh để tránh chậm trễ xem xét
• Sau khi kết nối, thường xuyên kiểm tra Bảng điều khiển Express qua "Mở bảng điều khiển" để theo dõi thanh toán và số dư
• Để thay đổi tài khoản ngân hàng, cập nhật trong Bảng điều khiển Express
• Nếu đã có tài khoản Stripe Express từ nền tảng khác, sử dụng "Đã có tài khoản?" để đồng bộ tự động

Mua và quản lý đầu đọc:

• Chọn đầu đọc phù hợp cho phòng khám: WisePOS E cho hầu hết phòng khám, S700/S710 cho trải nghiệm cao cấp
• Đặt nhãn mô tả cho mỗi đầu đọc (ví dụ: "Quầy lễ tân 1", "Đầu đọc phòng")
• Định kỳ nhấp "Đồng bộ từ Stripe" để giữ trạng thái thiết bị cập nhật
• Nếu đầu đọc hiển thị ngoại tuyến, kiểm tra mức pin và kết nối Wi-Fi
• Giữ firmware đầu đọc luôn cập nhật — Stripe tự động đẩy bản cập nhật

Cài đặt tiền tip:

• Tuân theo quy ước ngành cho phần trăm tiền tip (ví dụ: 15%/18%/20%)
• Thông báo cho nhân viên trước khi bật tiền tip để họ có thể hỗ trợ khách hàng có thắc mắc

Tối ưu chi phí:

• Khuyến khích thanh toán thẻ trực tiếp bất cứ khi nào có thể — với 2,8% + 5¢, mức phí thấp hơn đáng kể so với thanh toán nhập thủ công (3,5% + 30¢)
• Thường xuyên xem xét báo cáo phí trong Bảng điều khiển Stripe để hiểu cơ cấu chi phí thanh toán