Tích hợp POS

Trang cài đặt Tích hợp kết nối một máy chủ HandyCafe đủ điều kiện với thiết bị đầu cuối Ödeal D2D. Điều kiện sử dụng được kiểm tra qua HandyCafe Cloud. Mục menu và trang này bị ẩn hoàn toàn khi quán không được phép dùng Ödeal.

Trước Khi Bắt Đầu

Bạn cần một gói đăng ký HandyCafe Cloud đang hoạt động, một khóa merchant Ödeal và một khóa bí mật Ödeal. Bạn cũng phải tạo thiết bị đầu cuối trong mục Cihazlarım của Ödeal. Tên chính xác đã đặt cho thiết bị đó chính là externalDeviceKey của nó. Hãy bắt đầu với môi trường Stage. Chỉ chuyển sang Production sau khi Ödeal đã duyệt thông tin xác thực production và phần thiết lập callback.

Cấu hình Ödeal

1. Mở Cài đặt rồi chọn Tích hợp.
2. Trong Tài khoản Ödeal, nhập khóa merchant và khóa bí mật do Ödeal cung cấp. HandyCafe gửi thẳng các giá trị này lên HandyCafe Cloud. Chúng được mã hóa, không lưu trong cơ sở dữ liệu nội bộ và không hiển thị lại.
3. Chọn Kiểm tra Kết nối. Khi có khóa mới, HandyCafe lưu chúng an toàn trước rồi mới kiểm tra kết nối tới API Ödeal. Phép kiểm tra này chỉ xác minh tài khoản Ödeal. Nó không chứng minh rằng thiết bị đầu cuối đã ghép nối hay đang trực tuyến.
4. Thêm thiết bị đầu cuối. Nhập một tên thiết bị nội bộ rõ ràng. Ở ô Tên thiết bị Ödeal (externalDeviceKey), nhập đúng tên thiết bị đã tạo trong Ödeal. Sau đó nhập PaxID tùy chọn, môi trường, thời gian chờ thanh toán, tỉnh thành của khách, quận huyện của khách, thuế suất VAT cho phiên và thuế suất VAT cho đơn hàng.
5. Bật Tích hợp POS Đang hoạt động rồi chọn Lưu.
6. Hoàn tất một hóa đơn tiền mặt và một giao dịch thẻ trên môi trường Stage để xác minh việc ghép nối thiết bị cùng cả hai luồng quyết toán.

Bản phát hành này chỉ hỗ trợ một thiết bị đầu cuối Ödeal đang hoạt động trên mỗi máy chủ. Điều này tránh việc một khoản thanh toán bị định tuyến sang thiết bị không mong muốn khi chưa có bộ chọn thiết bị dành cho thu ngân.

HandyCafe lưu danh sách thiết bị ngay trên máy trước khi Cloud xác minh một cặp thông tin xác thực mới. Việc Ödeal từ chối thông tin xác thực không làm mất tên thiết bị hay các trường ghép nối. Thiết bị cần thông tin xác thực mới được lưu ở trạng thái không hoạt động cho tới khi thông tin đó được xác minh cho môi trường đã chọn.

Trang Tích hợp đọc danh sách thiết bị trực tiếp từ cơ sở dữ liệu SQLite nội bộ và hiển thị mà không cần chờ Cloud. Chỉ trạng thái của thông tin xác thực đã mã hóa và quyền dùng nhà cung cấp từ xa mới cần một yêu cầu tới Cloud.

Nếu Ödeal từ chối cấu hình, HandyCafe hiển thị phần giải thích do Ödeal trả về. Phản hồi báo không tìm thấy hồ sơ tổ chức nghĩa là cặp khóa merchant và khóa bí mật không thuộc về tổ chức nào trong môi trường Stage hoặc Production đã chọn.

Cách Thanh Toán Hoạt Động

Khi phương thức thanh toán đang chọn là tiền mặt hoặc thẻ, việc thanh toán phiên PC, thanh toán phiên console và việc đóng đơn hàng độc lập sẽ gửi một giỏ hàng idempotent tới Ödeal. Tiền mặt được gửi dưới dạng tùy chọn thanh toán CASH theo tài liệu của Ödeal. Thiết bị đầu cuối ghi nhận khoản tiền mặt rồi in phiếu tài chính hoặc hóa đơn e-Archive mà không mở màn hình thu tiền bằng thẻ. Thẻ được gửi dưới dạng CREDITCARD. HandyCafe chờ kết quả callback trong lúc khách hoàn tất thanh toán trên thiết bị. Một lần thanh toán có cả tiền mặt lẫn thẻ sẽ gửi cả hai tùy chọn thanh toán kèm số tiền tương ứng.

Khách có thể chọn phương án trả góp trên thiết bị khi thẻ và hợp đồng merchant hỗ trợ. HandyCafe lưu số kỳ trả góp được báo về cùng với đơn bán nội bộ. Đơn bán nội bộ chỉ được ghi nhận sau khi Ödeal xác nhận giao dịch. Nếu việc ghi nhận nội bộ thất bại sau khi đã có xác nhận, HandyCafe sẽ yêu cầu hủy giao dịch trong ngày. Một lệnh hủy thất bại sẽ tạo ra lỗi cần đối chiếu thủ công và phải được kiểm tra trong báo cáo giao dịch của Ödeal. Các loại phương thức thanh toán khác ngoài tiền mặt và thẻ vẫn đi theo luồng quyết toán sẵn có của HandyCafe.

Kiểm tra và Thao tác trên Thiết bị

Kiểm tra Kết nối chỉ xác minh thông tin xác thực merchant Ödeal cùng quyền truy cập API. Nó không in hóa đơn, không tính tiền thẻ và không chứng minh rằng externalDeviceKey đã được ghép nối với thiết bị.

Tài liệu API D2D được cung cấp không định nghĩa endpoint riêng cho In hóa đơn thử hay Giao dịch thử. Việc kiểm thử nghiệm thu dùng giỏ hàng thông thường trong môi trường Stage: gửi một giỏ hàng tiền mặt rồi kiểm tra phiếu in ra, sau đó gửi một giỏ hàng thẻ và hoàn tất một giao dịch trả một lần hoặc trả góp trên thiết bị. Chỉ dùng thông tin thẻ thử nghiệm Stage do Ödeal cung cấp.

Các tình huống nghiệm thu của Ödeal có bao gồm đóng ngày và in lại hóa đơn cuối, nhưng đó là các thao tác trên thiết bị. D2D không có tài liệu về lệnh gọi API từ xa cho những việc này, nên HandyCafe không đưa chúng ra thành nút bấm từ xa.

Bật và Tắt từ Xa

Quản trị viên HandyCafe điều khiển Ödeal từ Quản trị > Cài đặt Quản trị > Nhà cung cấp POS trên Dashboard. Công tắc toàn cục là quyền kiểm soát cao nhất. Giá trị mặc định theo quốc gia dùng mã ISO hai chữ cái, chẳng hạn TR. Phần điều khiển theo quán có thể mở hoặc đóng Ödeal một cách rõ ràng cho một giấy phép. Quyết định riêng cho quán sẽ ghi đè mặc định của quốc gia. Đặt lại quyết định của quán sẽ khiến quán đó theo quốc gia trở lại.

Thứ tự quyết định là công tắc toàn cục, rồi quyết định riêng cho quán, rồi mặc định của quốc gia. Công tắc toàn cục bị tắt sẽ đóng Ödeal cho mọi quán. Một lệnh đóng rõ ràng ở cấp quán sẽ ẩn trang này ngay cả khi quốc gia của quán đang mở. Một lệnh mở rõ ràng ở cấp quán cho phép hiện trang ngay cả khi quốc gia đó không nằm trong danh sách mặc định. Việc tắt quyền truy cập chặn ngay việc tạo giỏ hàng mới. Các giao dịch đang chờ vẫn có thể được kiểm tra hoặc hủy để một khoản thanh toán dở dang không bị bỏ lửng.

Máy chủ kiểm tra điều kiện sử dụng qua HandyCafe Cloud và lưu vào bộ đệm quyết định quốc gia hoặc quán đã được xác minh thành công gần nhất. Danh mục nhà cung cấp trả về HTTP 200 kèm error.code có cấu trúc khi thông tin xác thực của nó không hợp lệ. Ứng dụng trên máy tính xử lý phản hồi đó bằng cách làm mới thông tin xác thực rồi thử lại. Một lỗi xác thực hoặc lỗi mạng tạm thời không làm quyết định bật của quản trị viên bị hiểu nhầm thành tắt, nhờ vậy menu Tích hợp vẫn ổn định. Một phản hồi thành công sau đó sẽ cập nhật bộ đệm ngay lập tức, kể cả khi đó là quyết định tắt của quản trị viên. Khi chưa có quyết định nào được xác minh trước đó, một quốc gia quán chưa xác định, gói đăng ký không hoạt động hoặc nhà cung cấp bị tắt đều khiến trang tiếp tục bị ẩn. Các thao tác Ödeal mới luôn được Cloud cấp phép lại kể cả khi đang dùng khả năng hiển thị lấy từ bộ đệm. Quốc gia lưu trên giấy phép sẽ được dùng khi hồ sơ quán đã đồng bộ không có quốc gia.

Bảo mật và Khôi phục

Thông tin xác thực Ödeal được mã hóa trong HandyCafe Cloud bằng khóa vault của bản triển khai. Yêu cầu callback được xác thực bằng khóa yêu cầu đã cấu hình hoặc bằng các header merchant và secret của Ödeal. Mã tham chiếu giỏ hàng là cố định cho từng đơn hàng hoặc từng phiên. Lặp lại cùng một lần thanh toán không tạo ra khoản thu thứ hai.

Việc hủy giao dịch Ödeal chỉ khả dụng theo quy định trong ngày của Ödeal, trước khi lô giao dịch trên thiết bị được đóng. Một giỏ hàng đang chờ có thể được gỡ riêng trước khi thanh toán hoàn tất. Ödeal D2D không cung cấp thao tác hoàn tiền tổng quát. Hãy dùng back office và báo cáo giao dịch của Ödeal khi thời hạn hủy đã trôi qua.

Ödeal D2D không có tài liệu về thao tác báo cáo Z hay đóng ngày từ xa. Hãy hoàn tất việc đóng ngày trên thiết bị. HandyCafe có thể đọc báo cáo giao dịch để đối chiếu và ghi nhận các callback payback từ Ödeal.