Cài đặt thanh toán
Tìm hiểu cách cấu hình thanh toán Stripe, quản lý thiết bị POS và thiết lập tùy chọn tiền tip trong Kuee
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:
| Tab | Chức năng |
|---|---|
| Cài đặt tài khoản | Kết nối và quản lý tài khoản Stripe |
| Thiết bị POS | Đăng ký và quản lý đầu đọc thẻ vật lý |
| Giao dịch | Xem lịch sử thanh toán Stripe Terminal |
| Cài đặt nâng cao | Cấu hình tùy chọn tiền tip cho đầu đọc thẻ |
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:
- Nhấp Connect Stripe trên tab Cài đặt tài khoản
- 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.)
- Gửi tất cả các bước — Stripe xem xét và tự động chuyển hướng bạn về Kuee
- 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:
| Hành động | Mô tả |
|---|---|
| Tiếp tục cài đặt | Quay lại Stripe để hoàn tất các bước đăng ký còn lại |
| Ngắt kết nối | Xóa tài khoản chưa hoàn tất và bắt đầu lại quy trình kết nối |
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:
| Thông tin | Mô tả |
|---|---|
| Loại hình kinh doanh | Loại hình kinh doanh đã đăng ký |
| Địa chỉ email liên kết với tài khoản Stripe | |
| Quốc gia | Quốc gia của tài khoản |
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).
Danh sách đầu đọc
| Cột | Mô tả |
|---|---|
| Đầu đọc | Nhãn/tên thiết bị |
| Mẫu | Mẫu thiết bị (ví dụ: BBPOS WisePOS E, Stripe Reader S700) |
| Số seri | Số seri duy nhất của thiết bị |
| Trạng thái | Trực tuyến / Ngoại tuyến |
| Hành động | Tùy chọn quản lý |
Thêm đầu đọc
Nhấp Thêm đầu đọc ở góc trên bên phải:
- 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
- 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")
- 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:
| Chỉ số | Mô tả |
|---|---|
| Tổng doanh thu | Tổng số tiền thu được trong khoảng thời gian đã chọn |
| Tổng giao dịch | Số giao dịch đã hoàn thành |
| Tỷ lệ thành công | Phần trăm giao dịch thành công |
| Số tiền trung bình | Số tiền giao dịch trung bình |
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
| Trạng thái | Ý nghĩa |
|---|---|
| Thành công | Thanh toán hoàn tất thành công |
| Đang xử lý | Thanh toán đang tiến hành |
| Đã hủy | Thanh toán đã bị hủy |
| Đang chờ | Đang chờ hành động tiếp theo |
| Thất bại | Thanh toán thất bại |
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:
- Bật nút Kích hoạt tiền tip đầu đọc
- Đặt ba tùy chọn Phần trăm tiền tip có sẵn (ví dụ: 15%, 18%, 20%)
- 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:
| Khía cạnh | Stripe Express (Kuee) | Tài khoản Stripe thông thường |
|---|---|---|
| Đăng ký | Qua nút "Connect Stripe" của Kuee | Tự đăng ký tại stripe.com |
| Đăng ký ban đầu | Biểu mẫu do Stripe lưu trữ, cấu hình sẵn cho Kuee | Đăng ký đầy đủ Stripe |
| Bảng điều khiển | Bảng điều khiển Express (thu nhập, thanh toán, thông tin doanh nghiệp) | Bảng điều khiển Stripe đầy đủ |
| Mua đầu đọc | Qua Cửa hàng Kuee (xem bên dưới) | Trực tiếp từ Bảng điều khiển Stripe |
| Xác minh danh tính | Stripe xử lý tự động | Tự quản lý |
Các bước thiết lập
- Trong Kuee, đi đến Cài đặt hệ thống > Cài đặt cơ bản > Cài đặt thanh toán
- Trên tab Cài đặt tài khoản, nhấp Connect Stripe
- 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
- Hoàn thành tất cả các bước và nhấp Gửi
- Stripe xem xét thông tin và tự động chuyển hướng bạn về Kuee
- 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.
| Mẫu | Loại | Tính năng | Phù hợp cho |
|---|---|---|---|
| BBPOS WisePOS E | Đặt bàn | Màn hình cảm ứng, Wi-Fi, hỗ trợ NFC/chip/quẹt | Thanh toán tại quầy lễ tân — lựa chọn đầu tiên được khuyến nghị |
| Stripe Reader S700 | Đặt bàn cao cấp | Màn hình cảm ứng lớn, bộ xử lý nhanh hơn, giao diện tùy chỉnh | Phòng khám có lưu lượng cao, trải nghiệm thương hiệu |
| Stripe Reader S710 | Đặt bàn cao cấp | Thế hệ mới nhất của S700, hiệu suất cải thiện | Trải nghiệm cao cấp, phần cứng mới nhất |
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í
| Loại giao dịch | Mức phí |
|---|---|
| Thanh toán trực tiếp (Card Present) | 2,8% + 5¢ mỗi giao dịch |
| Thanh toán thẻ nhập thủ công | 3,5% + 30¢ mỗi giao dịch |
| Thẻ quốc tế | Thêm 1,5% |
| Tranh chấp / Hoàn tiền | $15 mỗi tranh chấp |
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í
| Số tiền thanh toán | Phí trực tiếp | Phí nhập thủ công |
|---|---|---|
| $50 | $1,45 | $2,05 |
| $100 | $2,85 | $3,80 |
| $200 | $5,65 | $7,30 |
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
| Vấn đề | Giải pháp |
|---|---|
| Đầu đọc hiển thị ngoại tuyến | Kiểm tra thiết bị có kết nối Wi-Fi ổn định và đủ pin. Thử khởi động lại đầu đọc và chờ 1–2 phút để kết nối lại |
| Đầu đọc không xuất hiện sau khi đăng ký | Nhấp nút Đồng bộ từ Stripe trên tab Thiết bị POS và chờ hệ thống lấy thông tin thiết bị cập nhật |
| Hết thời gian kết nối khi thanh toán | Xác minh kết nối internet của phòng khám ổn định. Đầu đọc có cơ chế tự động thử lại — chờ vài giây và thường sẽ phục hồi |
| Số tiền tip không chính xác | Xác minh cài đặt phần trăm tip trong Cài đặt nâng cao. Sau khi lưu, chờ vài phút để cấu hình đồng bộ đến đầu đọc |
Sự cố thanh toán
| Vấn đề | Giải pháp |
|---|---|
| Thẻ khách hàng bị từ chối | Yêu cầu khách hàng xác minh hạn mức và ngày hết hạn thẻ. Thử thẻ khác nếu có |
| Tiền chưa về | Lịch thanh toán tiêu chuẩn của Stripe là 2 ngày làm việc. Đăng nhập Bảng điều khiển Stripe để kiểm tra các khoản giữ lại hoặc thông báo |
Sự cố tài khoản
| Vấn đề | Giải pháp |
|---|---|
| Đăng ký Stripe Connect bị từ chối | Đảm bảo tất cả thông tin đã gửi khớp chính xác với giấy đăng ký kinh doanh và giấy tờ tùy thân. Nếu vẫn bị từ chối, liên hệ Hỗ trợ Stripe |
| Trạng thái kết nối tài khoản bất thường | Nhấp Kết nối lại trên tab Cài đặt tài khoản để làm mới kết nối |
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