This detailed step-by-step guide will walk you through assigning and configuring the Dejavoo payment module in SambaPOS.

Follow each section carefully to ensure proper setup.

 

Step 1: Assign a Dejavoo License

1.1. Log in to the SambaPOS License Control Panel (CP)

– Open a browser and go to https://cp.sambapos.com/signin
– Enter your credentials (username and password) to log in.

1.2. Assign the Dejavoo License

– Navigate to the License Management section.
– Locate the option for Dejavoo license and assign it to your account or demo account.

1.3. Important Notes:

– The Dejavoo license is free of charge, so assigning it will not incur additional fees.
– Verify that the license is assigned correctly before proceeding to the next step.

1.4. Verify License Assignment:

– Once assigned, check your active licenses to confirm the Dejavoo license is listed.
– If the license does not appear, refresh the page or contact SambaPOS support.

 

 

Step 2: Locate the Payment Controller Folder

2.1. Find the SambaPOS Installation Root Folder:

– The default installation location for SambaPOS is typically:
C:\Program Files\SambaPOS\
Alternatively, if a custom location was chosen during installation, find the corresponding directory (e.g., C:\SambaPOS\).

2.2. Open the Payment Controller Folder:

– In the root folder, locate and open the subfolder named Payment Controllers.

 

 

Step 3: Identify and Copy the Required DLL Files

3.1. Locate the Following Two DLL Files:

– Samba.Modules.DejavooController.dll
– Samba.Modules.PaymentOperations.dll

3.2. Verify File Names Carefully:

– Ensure you select only the two DLL files mentioned above. Selecting incorrect files may prevent SambaPOS from functioning properly.

3.3. Copy the Files:

– Highlight the two required files.
– Right-click and select Copy, or use the keyboard shortcut Ctrl+C.

 

 

 

Step 4: Paste the DLL Files to the Root Folder

4.1. Navigate Back to the Root Folder:
– Go back to the main SambaPOS root directory, where you initially located the Payment Controllers folder.

4.2. Paste the Files:
– Right-click in the root folder and select Paste, or use the keyboard shortcut Ctrl+V.

4.3. Critical Reminder:
– Do NOT copy any additional files from the Payment Controllers folder. Copying incorrect files may cause issues with SambaPOS loading or functionality.

 

 

 

Step 5. Setting Up the Custom Navigation Screen

  • Go to Main Menu > Manage > Settings > Program Settings > Maintenance.
  • Click Create Default Navigation Buttons and save your changes.
  • Enable custom navigation in Main Menu > Manage > Settings > Local Settings > Display.

 

 

Step 6. Creating an Automation Command

Navigate to Main Menu > Manage > Automation > Automation Commands > Here click onAdd Automation Command

6.1. General Settings Section;

 

Name: Dejavoo

Category: Navigation

Button Header: Dejavoo

Color: [Choose desired color]

Clear Selection: Enabled

6.2. Navigation Settings;

Symbol: [Choose a symbol]

Navigation Module: Payment Operations

 

6.3. Mappings Section;

Add a new row in Mappings with Visibility: Display on Navigation.

Save your changes.
 

Step 7. Restart SambaPOS V5 Pro

After completing the setup, restart SambaPOS V5 Pro to apply changes.

7.1. Close SambaPOS:
– Ensure SambaPOS is completely closed. Use Task Manager to confirm no background processes are running.

 

7.2. Restart SambaPOS:
– Relaunch SambaPOS to apply the changes made during the DLL file configuration.

 

 

 

Step 8: Obtain Dejavoo Local Settings

8.1. Log in to the ISOPays Portal:
– Open a browser and go to https://portal.ipospays.com/auth/login
– Use your credentials to log in to the portal.

8.2. Activate Spin Cloud Mode:
– In the portal, from the left navigateion bar, go to the S.T.E.A.M..
– S.T.E.A.M. > Edit Parameters.
– Select the device from the device list.
– Once the correct device has been selected, select Edit Parameters from the list above the device’s information.
– Under Edit Parameters > Integration and turn on SPIN

 

 

8.3. Gather Required Information:
– From the ISOPays portal, collect the following credentials:
TPN (Terminal Processing Number)
Register ID
Auth Key

 

 

Step 9: Access the Dejavoo Program Module Settings in SambaPOS

9.1 Navigate to the “Manage Settings” Section:
– Open the Settings tab in the SambaPOS interface from the left-hand menu.

9.2. Open Program Settings:
– Go to Settings > Program Settings.

9.3. Locate Module Settings:
– In the Settings > Program Settings > Module Settings, find the new module settings for Dejavoo.

9.4. Confirm Availability:
– If the Dejavoo settings do not appear, recheck the DLL file placement and licensing.

 

 

Step 10: Access the Dejavoo Local Module Settings in SambaPOS

10.1. Go to the “Manage” Section:
– Return to the Settings tab in SambaPOS.

10.2. Open Local Settings:
– Navigate to Settings > Local Settings.

10.3. Access Modules:
– Within Settings >Local Settings, click on the Modules tab.
– Locate the section for Dejavoo settings.

10.4. Confirm Availability:
– If the Dejavoo settings do not appear, recheck the DLL file placement and licensing

10.5. Enter Information into SambaPOS:
– Fill in the fields with the credentials from the ISOPays portal:
– Enable Controller: Enable this option.
– Can Adjust Tip: Check this box to allow tip adjustments on the terminal.
– Can Refund: Check this box to enable refund functionality.
– TPN: Enter the terminal processing number from ISOPays.
– Register ID: Enter the register ID from ISOPays.
– Auth Key: Enter the authentication key from ISOPays.
– Logging: Enable this option if you need to track activity for debugging.

10.6. Save the Configuration:
– Double-check all fields for accuracy.
– Click Save to finalize the configuration.

 

 

Step 11: Final Checks

11.1. Perform a Test Transaction:
– Process a test transaction to verify the Dejavoo module is working as intended.
– Look for error messages or incomplete configurations.

11.2. Verify Terminal Settings in ISOPays:
– Log back into the ISOPays portal and ensure the terminal settings align with the configuration in SambaPOS.