KAI-Pay
Ví

Quầy thu ngân – Hướng dẫn cho người bán

Với quầy thu ngân KAI-Pay, bạn nhận thanh toán bằng bitcoin qua Lightning, ví dụ tại quầy bán hàng hoặc sạp chợ. Quầy thu ngân là một trang riêng (kasse.kai-pay.net) không chứa khóa: nó chỉ có thể tạo hóa đơn, không thể gửi tiền. Mỗi khoản thanh toán đi thẳng vào ví KAI-Pay tự lưu ký của bạn. Tại đó bạn xem báo cáo chốt sổ ngày và tháng, và có thể hoàn tiền.

KAI-Pay đang ở giai đoạn beta công khai. Quầy thu ngân là thiết bị đầu cuối thanh toán, không phải máy tính tiền (xem Giới hạn).

1. Điều kiện cần

2. Thiết lập quầy thu ngân

  1. Trong ví, mở menu và chọn “Quầy thu ngân & chốt sổ”. Ở cuối cùng có mục “Thiết lập quầy thu ngân”.
  2. Tùy chọn: nhập tên quầy, ví dụ “Quầy 1” hoặc “Sạp chợ”. Khi đổi tên, liên kết và mã QR cũng thay đổi theo.
  3. Mở quầy thu ngân:
    • Trên cùng thiết bị: “Mở quầy thu ngân trên thiết bị này”. Quầy thu ngân mở trong một tab mới, hoặc trong trình duyệt nếu bạn dùng ứng dụng Android.
    • Trên một thiết bị thu ngân riêng (ví dụ máy tính bảng đặt ở quầy): quét mã QR bằng thiết bị đó, hoặc sao chép hay chia sẻ liên kết rồi mở trên thiết bị đó.

Liên kết chứa địa chỉ Lightning của bạn, tên quầy và một khóa biên lai công khai. Các thông tin này nằm ở phần liên kết phía sau dấu “#”; chúng không được gửi đến máy chủ nào. Quầy thu ngân lưu chúng trên thiết bị thu ngân. Lần sau khi bạn mở kasse.kai-pay.net, quầy thu ngân khởi động ngay; bạn không cần liên kết nữa.

Nếu ai đó mở trên một thiết bị thu ngân đã thiết lập một liên kết có địa chỉ khác hoặc khóa biên lai khác, quầy thu ngân sẽ hỏi lại trước khi chuyển đổi. Chỉ xác nhận nếu chính bạn đã thiết lập. Quầy thu ngân và ví đều hiển thị dấu vân tay của khóa biên lai; bạn có thể so sánh.

3. Thu tiền

  1. Nhập số tiền: bằng một đồng tiền quốc gia (EUR, USD, GBP, CHF, CAD, AUD hoặc JPY, quy đổi theo tỷ giá của mempool.space được hiển thị kèm thời điểm cập nhật) hoặc bằng sat (“Nhập bằng sat”). Tỷ giá được chốt cố định cho hóa đơn. Khi thu bằng tiền quốc gia, quầy thu ngân chỉ thu tiền với tỷ giá được lấy cách đây tối đa 5 phút và theo mempool.space không cũ hơn 30 phút.
  2. “Thu tiền”: quầy thu ngân hiển thị hóa đơn dưới dạng mã QR.
  3. Khách hàng quét mã bằng bất kỳ ví Lightning nào và thanh toán.
  4. Quầy thu ngân hiển thị “Đã thanh toán” và một biên lai thanh toán có số. Đây là bằng chứng thanh toán, không phải phiếu tính tiền. “Biên lai PDF” lưu biên lai thành tệp.

Các thông báo của quầy thu ngân:

Thu tiền theo mặt hàng

  1. “Quản lý mặt hàng”: tên, giá và loại tiền của giá (tiền quốc gia hoặc sat), tùy chọn thêm nhóm hàng và thuế suất. Thuế suất chỉ là thông tin ghi trên biên lai; KAI-Pay không tính thuế.
  2. “Mặt hàng”: chạm vào mặt hàng, đổi số lượng bằng − và +. Mỗi giỏ hàng chỉ có đúng một loại tiền.
  3. “Thu tiền”: tổng tiền trở thành hóa đơn. Các dòng hàng, giá và tỷ giá được chốt cố định cho đơn này – việc đổi giá sau đó không làm thay đổi các biên lai đã thanh toán.

Mặt hàng chỉ được lưu trên thiết bị thu ngân. “Xuất danh mục” lưu chúng thành tệp; ở một quầy thu ngân khác hoặc trong ví (Quầy thu ngân & chốt sổ → Mặt hàng), dùng “Nhập danh mục” để nhập vào. Ví chỉ cần danh mục để hiển thị các dòng hàng kèm tên; nhập lại không làm thay đổi tên của những mặt hàng đã nhập trước đó. Đổi tên sẽ tạo một mặt hàng mới trong quầy thu ngân, để các biên lai cũ giữ nguyên tên.

Các dòng hàng và số tiền bằng loại tiền khác ngoài euro chỉ đến được ví nếu quầy thu ngân được thiết lập qua liên kết quầy thu ngân hiện tại trong ví của bạn. Với các quầy thu ngân đã thiết lập bằng liên kết cũ hơn: mở lại liên kết quầy thu ngân từ ví một lần. Trước đó, các dòng hàng chỉ có trên biên lai của quầy thu ngân.

Biên lai PDF

Quầy thu ngân và ví tạo biên lai PDF ngay trên thiết bị từ dữ liệu đã lưu, không cần máy chủ; nếu tạo lại, cùng một khoản thanh toán sẽ cho ra cùng một tệp (cùng ngôn ngữ và múi giờ). Quầy thu ngân chỉ giữ sẵn biên lai cho các hóa đơn gần đây của nó (tối đa 20 hóa đơn trong 7 ngày qua). Biên lai là bằng chứng thanh toán, không phải hóa đơn theo § 14 UStG (Đức) và cũng không phải phiếu tính tiền. Khi hoàn tiền, ví tạo một biên lai hoàn tiền riêng.

4. Tên quầy và nhiều quầy thu ngân

Ví không lưu tên quầy. Tên quầy được truyền đi như sau:

  1. Tên nằm trong liên kết. Quầy thu ngân lưu tên trên thiết bị thu ngân, cùng với một mã thiết bị ngẫu nhiên và một bộ đếm biên lai tăng dần.
  2. Với mỗi khoản thanh toán, quầy thu ngân gửi kèm một ghi chú được mã hóa: mã thiết bị, tên quầy, số biên lai, số tiền bằng tiền quốc gia và tỷ giá, nếu bán theo mặt hàng thì có cả các dòng hàng. Chỉ ví của bạn đọc được ghi chú này.
  3. Ví đọc các ghi chú này từ các khoản thanh toán và gán chúng cho từng quầy thu ngân trong báo cáo chốt sổ.

5. Chốt sổ ngày

Trong ví, vào “Quầy thu ngân & chốt sổ” và chọn một ngày. Với mỗi quầy thu ngân, bạn thấy:

Ngoài ra, ví còn liệt kê “Khoản tiền đến khác” (các khoản thanh toán đến địa chỉ của bạn nhưng không qua quầy thu ngân) và các khoản thanh toán còn đang chờ.

6. Chốt sổ tháng và xuất CSV

“Xuất ngày dưới dạng CSV” hoặc “Xuất tháng dưới dạng CSV” lưu một tệp với mỗi giao dịch một dòng:

Ở cuối tệp là các tổng tính bằng sat và theo từng loại tiền quốc gia.

Ví không giữ sổ quỹ riêng cho việc này. Mỗi lần, ví tính báo cáo chốt sổ từ lịch sử thanh toán. Vì vậy bạn có thể xuất lại bất kỳ tháng nào trước đây, miễn là các khoản thanh toán vẫn còn trong lịch sử. Ví suy ra khóa cho các ghi chú biên lai từ 12 từ khôi phục của bạn; kể cả sau khi khôi phục ví, các ghi chú vẫn đọc được.

Tệp xuất của quầy thu ngân chỉ chứa các khoản thanh toán qua quầy thu ngân. Để có bản tổng quan về tất cả các khoản thu, hãy xuất thêm lịch sử của ví dưới dạng CSV; tệp này chứa mọi khoản thanh toán.

7. Hoàn tiền

  1. Trong ví, mở khoản thanh toán từ quầy thu ngân trong lịch sử và chọn “Hoàn tiền”.
  2. Nhập địa chỉ Lightning hoặc hóa đơn của khách hàng. Bạn chỉ có thể hoàn tối đa số tiền còn chưa được hoàn.
  3. Kiểm tra và xác nhận. Khoản hoàn tiền xuất hiện trong báo cáo chốt sổ với dấu trừ. Với những địa chỉ Lightning nhận ghi chú, ví gửi kèm “Hoàn tiền cho biên lai …”.

Ví chỉ lưu mối liên kết “Hoàn tiền cho biên lai” trên thiết bị bạn đã dùng để hoàn tiền. Nếu một khoản hoàn tiền vẫn đang được chuyển, ví sẽ cảnh báo trước khi bạn hoàn lần thứ hai.

8. Bảo mật và dữ liệu

9. Giới hạn

Có câu hỏi? Câu hỏi thường gặp hoặc kontakt@kai-pay.net.