Skip to main content

Fiuu VT+

The Fiuu VT+ is a production-ready solution designed to seamlessly integrate with cloudECR, enabling secure and efficient electronic cash register operations. This terminal is optimized for real-time transactions and ensures compliance with cloudECR standards.

Key Features​

  • Production-Ready: Fully tested and certified for live environments.
  • Cloud Integration: Direct connectivity with cloudECR for transaction synchronization.
  • User-Friendly: Simple activation and configuration steps.

Steps to Use and Test Integration​

1. Download the VT+ App​

  • Visit your device’s app store (Apple App Store or Google Play Store).
  • Search for Fiuu VT+ and download the latest version.

2. Generate VT+ account​

  • Log in to the Merchant Portal and navigate to VT Activation > List section, click on + New VT Terminal button and confirm the creation.

    Create New VT+ Account

  • Save the generated QR code for later use and click Complete.

    Complete Account Creation

  • To enable cloudECR integration, toggle the Enable cloudECR option.

    Enable cloudECR

3. Activate the Terminal​

  • Open the VT+ app and tap Activate.

  • Review the Privacy Policy, check the agreement box, and tap Agree.

  • Scan the saved QR code and set your application passcode.

  • The terminal status will initially show Offline, as no POS is yet bound.

    Activate Terminal

4. Set Secret Key​

The cloudECR Secret Key is the shared secret used to sign every message exchanged between the POS and the terminal. The same key must be configured on both the POS side and in the VT+ app before any transaction is attempted.

If the key is missing or does not match the one issued for your cloudECR account, requests will be rejected with an invalid signature error (40026 / 40320). See Signature for how the signature is generated.

4.1 Retrieve the Secret Key​

Retrieve Secret Key

Steps

  • Log in to the Merchant Portal and navigate to the cloudECR section.
  • Click the Secret Key button in the action bar of the Create New API Account for POS panel.
  • In the Secret Key dialog, click the eye icon to reveal the key or the copy icon to copy it, then click Close.

4.2 Set the Secret Key in the App​

Set Secret Key

Steps

  • On the VT+ home screen, tap the key icon at the top right corner.
  • In the cloudECR Secret Key dialog, paste or type the key into the Enter key here field, or tap the scan icon inside the field to scan it, then tap OK.
  • Confirm the key was saved by tapping Settings and selecting cloudECR, where the cloudECR Key is shown in masked form along with the POS and cloudECR connection status.

Notes

  • The secret key accepts a maximum of 40 characters.
  • Copy the key exactly as shown. It is case-sensitive, and a mistyped or truncated key produces an invalid signature error on every transaction.
  • Retrieve the key again from the Merchant Portal if it is lost; it is never displayed in full within the app.

5. Bind the Terminal​

5.1 QR Scan Binding​

QR Scan Binding allows the application to pair with the POS terminal by scanning a QR code generated from the POS system. The QR code contains the necessary identification details, enabling the application to establish the connection automatically.

Bind Terminal

Steps

  • In the application, tap Bind with POS.
  • Scan the QR Code generated by the POS system and wait for the system to process the binding request.
  • Confirm that the binding is successful by checking the POS and cloudECR status.

Notes

  • Ensure the QR code displayed on the POS system is clearly visible and not expired before scanning.
  • If the binding is unsuccessful, the message shown in Step 4 of the diagram will appear.

5.2 Express Binding​

Express Binding allows the application to quickly bind to a terminal that has already been preassigned in the Merchant Portal. Once triggered, the system will automatically locate the prebound terminal and complete the binding process without

Prerequisite

  • The target terminal must be assigned through Prebind selection before proceeding. Skipping this will result in the Express Bind button not appearing.

Bind Terminal

Steps

  1. In the application, tap Settings at the top left corner, then select cloudECR from the settings menu.
  2. Tap the Bind button.
  3. Tap Express Bind to initiate the binding process.

For more details, see the Bind Terminal section.

6. Perform Transfer Test​

  • Initiate a Test Transaction from the POS.

  • Ensure the transaction flows as follows:
    POS → Terminal (processing) → Terminal → POS (response)

  • Sample Sale test:

    Sale Test

  • Sample Void test:

    Void Test

7. Troubleshooting​

  • Connection Issues: Ensure a stable internet connection and correct merchant account credentials.
  • Binding Errors: Double-check cloudECR settings and retry the binding process.
  • Invalid Signature (40026 / 40320): Confirm the cloudECR Secret Key set in the app matches the one shown in the Merchant Portal, and that the POS is signing with the same key. Re-enter the key by following Set Secret Key.
  • For persistent issues, contact Support and provide error logs.

Best Practices​

  • Always keep the terminal app updated.
  • Regularly monitor transaction logs for discrepancies.
  • Perform periodic test transactions after major updates.