Setup Micros Simphony to Work with Peoplevine

You can setup your Micros Simphony (with Transaction Services enabled) to lookup members, sync orders and take payment direct from the POS.


Through our integration with Micros Simphony, you have the ability to:

  • Track member spend by finding and attaching the member to the order
  • Apply a member-only check-level discount
  • Allow members to pay with card on file for instant payment via Peoplevine
  • Allow members to pay with house account that generate an invoice in Peoplevine
  • Allow members to pay with stipends or gift cards generated in Peoplevine

To start leveraging this integration, there are a few things you need to configure.  The first being adding your integration to Peoplevine and generating a key.  The second is configuring your Micros Simphony through EMC for extensibility.  Lets get started with setting up Peoplevine as you'll need that key first.

Please note that our integration supports the following versions of Micros Simphony:

  • Cloud Installs - 18.2+, 19.1, 19.2
  • On Premise Installs - 2.7. 2.8, 2.9, 2.10, 18.2+, 19.1, 19.2

You must be using Windows terminals to support our integration.

A general overview of the flow can be seen below.


Adding Your Micros Simphony Integration to Peoplevine

To get started with integrating Peoplevine with Micros Simphony, please make sure you have Transaction Services enabled in your Simphony environment.  Once you have confirmed this is in place, lets get started with requesting an API Key to connect your Micros Simphony instance to your Peoplevine account.

In the Control Panel, go to Platform Integrations and click on Micros Simphony.

Here you'll select the location associated with this setup and add a name to keep track of this specific location.

Once you click to Authenticate with Peoplevine Connect, you will be prompted to login and generate credentials to be used in this connection.

Enter your username/pw to authenticate with this app.  Upon a successful login, you will be routed back to the authentication where the system will prompt you to download the files to install on each terminal.

You will need to select the version that matches your version of Simphony and install both the config file and the dll.

You will also notice that Micros Simphony is activated in Peoplevine, but no data will transfer until you complete the next step.

If you are connected to a location and need to re-download the config file, you can do this by clicking on Generate Config File for the location you want to download the file for.


Setting up Micros Simphony via EMC

Now that Peoplevine is configured and you have your API Key, go to your Micros Simphony Back of House and launch the EMC tool.

In EMC Setup->Extension Application create a new entry with name PVExtApp

To add a new row, click on the + icon when on the Extension Application tab.

Then enter the name PVExtApp as the Record Name and hit OK.  You can leave the rest as default settings.

In EMS Configuration->Discounts create a new entry with specified ID: 

 

In General set the “Enables”, “On = Open; Off = Preset” options on:

 

In RVC Type select all applicable:

In Itemizers set all applicable items:

In Menu Levels click on “Select All”

 

In EMS Configuration->Tender/Media create a new entry with specified ID

In General set “Key Type” to “Payment”:



In Options, click on Charge Tip Options and then check the tips.

In Menu Levels click on “Select All”

In EMS Configuration->Page Design right click on the Transaction/Payment page and click on Override Record->Use Existing Record.  If you are editing your page, you can double click on the Transaction row.

 

Select the content area where the Peoplevine buttons must be added and click on “Add Button”.  We recommend adding the member lookup to the Transaction Screen in the bottom.

Then add the payment buttons to the Pay screen on the Transactions page.

Set Type “Function” and select “Run Extensibility App From File”:

Click on “Generate Legend” and change the text. In Arguments set the following values:

  • type = dll
  • appname = PVExtApp
  • filename = PVExtApp.dll
  • script = 
  • function = SetMember (replace with the function you are wiring up)
  • arg = 

*Note for script and arg you will leave these blank.  For function, please refer to the table below, based on the button you setup.

 

Create 4 buttons with the following caption and function:

  1. Peoplevine Member: SetMember
  2. Peoplevine House Account: SetPaymentHouse
  3. Peoplevine Card on File: SetPaymentCard
  4. Peoplevine House Credits: SetPaymentBalance



Download the lastest install DLL files for Micros Simphony 19.1 or Micros Simphony 19.2.

Extract the files and open the PVExtApp.dll.config to edit it. Set the following settings:

Name

Description

Sample value

host

Peoplevine Connect Region

https://connect.peoplevine.com

auth_id

API Key from Peoplevine

Generate via Peoplevine Control Panel

discount_id

The ID created in step 2

70

payment_id

The ID created in step 3

70

company_no

Your company_no identified under Company Profile

123

username

Generated when you click authenticate with Peoplevine Connect

Copy from screen when setting up in Peoplevine

password

Generated when you click authenticate with Peoplevine Connect

Copy from screen when setting up in Peoplevine

region

1 for Region 1
2 for Region 2

The region you are associated with.


Close the Simphony client and then copy these files to each client in the C:\Micros\Simphony\WebServer\wwwroot\EGateway\Handlers directory:

  • PVExtApp.dll
  • PVExtApp.dll.config
  • PVPOSConnect.dll
  1. Start the POS Client Application by running ServiceHost.exe
  2. Perform a "Reload Workation Database" operation to update the worktation with latest configuration
  3. Restart the POS Client Application so the new extension application can be loaded (this is only done at start up)

For additional reference on installing an extension please see Oracle's documentation.


Testing the Micros Simphony + Peoplevine Integration

Now that you configured your Micros Simphony environment along with using hte key from your Peoplevine Integrations, you can now lookup members and sync orders back to their CRM profile in Peoplevine.  

Login to the terminal and add items to their ticket as you usually do (although you can swap the order of these steps).  When done, click on the Member icon to lookup and attach a member.

You will be prompted to lookup a member by their member ID or their mobile number.

Upon entering the members' ID or mobile number, the system will return the member's info if identified including their name, total discount, house credit balance and a flag if they have a card on file for payments.

If the person doesn't exist, the system will notify you that the member with ID or phone was not found.  Please note that they must be an Active member to show up in the POS.  If they are not active, they will need to speak with the membership team or reactivate in their portal before using their member privileges.

Now that the member is on the order, you can see this by tapping on the Peoplevine Member button.

When you are ready to take payment, you can then choose the payment option of choice.  For example House Account, Card on File and House Credits.  If the user doesn't have one of thes enabled (or doesn't have the credits) the sysetm will provide an error message.

Upon making payment, the system will automatically apply the discount to the order and close out payment.

Additional Help Tutorials

Find more ways to grow on PeopleVine.

Using Adyen as Your Payment Gateway

We support an integration with Adyen, a leader in payments in Europe, to process credit cards for all types of transactions including recurring billing, F&B, merch, event tickets and much more. This article will help you get things setup.

Posted July 20, 2021

Updated Affiliate Reporting for More Visibility and Accuracy

We recently updated our Affiliate engine with more detailed and actionable reporting to help you service your affiliates better and pay them sooner.

Posted July 13, 2021

Single Sign On (SSO) Using a JWT Token with Certificate

A new modern way to authenticate your members by leveraging our Single Sign On JWT Token that is validated by an updating certificate.

Posted July 9, 2021

Setup Micros Simphony to Work with Peoplevine

You can setup your Micros Simphony (with Transaction Services enabled) to lookup members, sync orders and take payment direct from the POS.

Posted June 15, 2021

Looking to Upgrade Your Authorize.Net Connection to 2.0 and Get Features Like Card Updater

If you are a legacy Authorize.net user, we recommend you upgrade to v2. It's quick and easy while giving you best in class security along with features like card updater from Authorize.net.

Posted June 14, 2021

You Can Sync Stripe Tokenized Credit Cards to Peoplevine

Do you have customers who added their payment directly in Stripe or from a previous integration? We can import those tokens to their CRM profile for future card on file charges.

Posted June 9, 2021

Set Member Perks to Issue on a Re-occurring Basis and to Sub Members (or not)

With our recent update to our Member Perks engine, you can now set a perk to re-issue on a regular basis. You can also control whether a sub member should receive this perk.

Posted May 27, 2021

Verify an Applicant hasn't Already Applied Before Continuing - Avoid Data Overlap

We added a new feature that allows you to prompt an applicant to enter their e-mail and/or mobile number in order to verify if they have either applied or are an active member.

Posted May 13, 2021

FAQ: Sevenrooms

Being integrated with Sevenrooms for nearly 3 years, we've learned a lot on how our users leverage it to improve the member experience while maximizing revenue. Here are some off the questions we get asked the most about our integration with Sevenrooms.

Posted May 11, 2021

Integrate Your Hardware to Verify Members as they Arrive

This step by step tutorial will show you how to verify a membership card and check them in via our API.

Posted May 11, 2021

Capture up to 3 Months Past Due When Members Don't Renew After Billing Fails

We are in a weird time where members may feel that no or limited access to the club doesn't warrant dues, so you may find people waiting to pay/activate until you re-open. If they do, this new feature will prompt them to pay up to the last 3 months they were inactive/unpaid.

Posted May 11, 2021

Adding a Card on File with Square for Dining

If you're using Square, we've updated our flow/experience for registering a card with Square for a card on file experience when dining.

Posted April 23, 2021

1 Hour Outage Due to Azure Downtime

We encountered an outage for an hour when Azure became unavailable. We contacted their support on Twitter to get them looking into it. Details inside.

Posted April 2, 2021

© Peoplevine 2021. Powered by PeopleVine. Terms of use | Privacy & cookies