Viva Wallet

Kết nối thiết bị đầu cuối thanh toán Viva Wallet payment terminal cho phép bạn cung cấp luồng thanh toán mượt mà cho khách hàng và giảm bớt công việc của nhân viên thu ngân.

Ghi chú

Viva Wallet cho phép bạn biến điện thoại của mình thành máy đọc thẻ di động: Tap On Phone.

Cấu hình

Bắt đầu bằng cách tạo tài khoản Viva Wallet của bạn trên trang web của Viva Wallet.

Tìm thông tin xác thực Viva Wallet của bạn

Khi cấu hình Viva Wallet trong Point of Sale, bạn cần sử dụng các thông tin xác thực cụ thể có sẵn trong tài khoản Viva Wallet của bạn. Các thông tin xác thực này bao gồm Merchant ID, API key, thông tin xác thực POS API, và số Terminal ID.

Merchant ID và API key

Tìm Merchant ID và API key của bạn theo tài liệu Viva. Sau đó, lưu các khóa và dán chúng vào các trường Merchant IDAPI Key trong SoOn khi tạo phương thức thanh toán.

merchant ID and API key fields

Ghi chú

Các thông tin xác thực này được sử dụng cho các API xác thực bằng Basic Auth.

Thông tin xác thực POS API

Tìm và tạo thông tin xác thực POS API của bạn theo tài liệu Viva. Sau đó, lưu các khóa và dán chúng vào các trường Client secretClient ID trong SoOn khi tạo phương thức thanh toán.

Cảnh báo

Các thông tin xác thực này chỉ được hiển thị một lần. Đảm bảo bạn lưu lại bản sao để bảo vệ chúng.

Client secret and client ID fields

Ghi chú

Các thông tin xác thực này được sử dụng cho các yêu cầu kích hoạt POS trên Android và iOS, cũng như API Cloud Terminal.

Terminal ID

Số Terminal ID của bạn được sử dụng để nhận diện thiết bị đầu cuối của bạn. Để tìm nó:

  1. Go to your Viva Wallet account and select the relevant account.

  2. Go to Sales ‣ Physical payments ‣ Card terminals in the navigation menu.

Số Terminal ID được đặt dưới cột Terminal ID (TID). Lưu nó để dán vào trường Terminal ID khi tạo phương thức thanh toán.

Viva terminal ID

Định cấu hình phương thức thanh toán

  1. Activate the POS Viva Wallet module to enable the payment terminal.

  2. Create the related payment method by going to Point of Sale ‣ Configuration ‣ Payment Methods and clicking New.

  3. Set the journal type as Bank.

  4. Select Viva Wallet in the Use a Payment Terminal field.

  5. Fill in the mandatory fields with your:

  6. Save the form and copy the generated webhook URL from the Viva Wallet Webhook Endpoint field. This URL is necessary when configuring the webhook.

biểu mẫu tạo phương thức thanh toán

Cấu hình webhook

Webhooks cho phép bạn nhận thông báo theo thời gian thực mỗi khi có giao dịch xảy ra trong tài khoản Viva Wallet của bạn. Thiết lập chúng cho giao dịch thanh toán theo tài liệu Viva.

Thanh toán bằng thiết bị đầu cuối thanh toán

Khi xử lý thanh toán, chọn phương thức thanh toán liên quan. Kiểm tra số tiền và nhấp vào Gửi. Khi thanh toán thành công, trạng thái sẽ chuyển thành Thanh toán thành công.

Ghi chú

  • Trong trường hợp có sự cố kết nối giữa SoOn và thiết bị đầu cuối thanh toán, hãy buộc thanh toán bằng cách nhấp vào Force Done, cho phép bạn xác thực đơn hàng.
    Tùy chọn này chỉ khả dụng sau khi nhận được thông báo lỗi cho bạn biết rằng kết nối không thành công.
  • Để hủy yêu cầu thanh toán, nhấp vào hủy.