Set Up a V400c Plus
Accept Any Payment at Any Time
Overview
The V400c Plus is a powerful and advanced countertop touchscreen device. It combines the latest in features, functionality, and performance into an efficient, high-end solution. It has the ability to work as a standalone terminal or to be connected to a POS application over cloud or over USB.
The device can accept credit cards via the following methods:
- EMV Chip (for Vantiv merchants only)
- Swipe
- NFC/CTLS (Contactless)
V400c Plus User Manual & Installation Guide:
For detailed setup instructions and technical specifications, refer to the comprehensive guide:
- V400c Plus User Manual & Installation Guide (Desktop)
- V400c Plus User Manual & Installation Guide (Mobile)
This manual covers both desktop and mobile configurations, ensuring a smooth installation and setup process for optimal use.
Getting Started
Before you can start testing with the V400c Plus, ensure you’ve completed the following steps:
- Set up your Sandbox or Production Merchant Account with Forte. To set up an account, complete the following steps:
- For a Sandbox Account, go to the Forte Test Account Setup page to sign up.
- For a Production account, contact Forte’s Sales Team at sales@forte.net
- Procure a V400c Plus by placing an order at Forte’s Equipment page.
- Procure the following cables and accessories depending on your configuration:
- V400c Plus Cable and Connector (Semi-Hybrid – Over USB Only)
- Ethernet Cable
- Receipt Paper
NOTE: All accessories except for the Ethernet cable should be ordered from Forte’s Equipment page.
The following image displays the ports for each cable and connector.
Integrating with Forte Checkout
Refer to the Getting Started section before setting up your device. You can set up your V400c Plus with Forte Checkout either in Cloud-hybrid mode or in Semi-hybrid mode (via the USB cable).
Integrating with Forte Checkout in Cloud-hybrid mode
To integrate your V400c Plus with Forte Checkout in Cloud-hybrid, complete the following steps:
- In your button code, pass in the
swipe=EMV-1
parameter. This indicates that Forte Checkout should accept input from the V400c Plus. Refer to the Coding the Button section of the Forte Checkout integration documentation. - Optional Step: Add
serial_number
button parameter to Forte Checkout HTML. Refer to the Coding the Button section of the Forte Checkout integration documentation.- NOTE: If
serial_number
parameter is passed with a terminal serial number(s) in the button code, then only the device(s) passed in the button parameter is displayed in the “Terminal” drop-down in Forte Checkout. - If
serial_number
parameter is not passed or passed as null in the button code, then all the terminal(s) associated with the Location is displayed in the “Terminal” drop-down in Forte Checkout. Users can choose the required terminal from the drop-down.
- NOTE: If
- Once a terminal is selected in the “Terminal” drop-down, Forte Checkout displays a Read Card button. Once the button is clicked, Forte Checkout sends the amount to be collected to the device, and the device will prompt the customer to present the card.
- Once the customer presents his/her card, the V400c Plus reads the card, sends an authorization request to Forte, and then receives the authorization response:
- If the transaction is approved, the V400c Plus prints an EMV-compliant receipt and passes the authorization response message to Forte Checkout.
- If the transaction is declined, the V400c Plus displays a decline message and passes the decline response back to Forte Checkout, which displays the decline code and reason.
With this setup, receipt printing is only handled by the V400c Plus.
Migrating from Semi-hybrid (via USB) to Cloud-hybrid
Existing Merchants can switch to Cloud-hybrid from Semi-hybrid by following these simple steps:
- Please reach out to our integration team at EquipmentQuestions@forte.net or 866-290-5400 (select option 5 for the Tech Support Queue then option 4 for the Equipment Queue), to have your terminal set up in Cloud-hybrid mode.
- Once the Technical Support team updates your terminal to cloud-hybrid mode you must:
- Un-install the Device Handler from your windows system:
- In the Windows Search input: type Add or remove programs
- Search for “Forte Payment Device Handler” in “Search apps” search box.
- Click on the three horizontal buttons corresponding to Forte Payment Device Handler (…) and click Uninstall
- Click “Uninstall” on the confirmation pop-up.
- Remove the USB cable that connects your terminal to your computer.
- Un-install the Device Handler from your windows system:
Integrating with Forte Checkout - Semi - hybrid via USB
Refer to the Getting Started section before setting up your device. To set up your V400c Plus with Forte Checkout, complete the following steps:
- Download and install the Forte Payments Device Handler and the Verifone Unified Driver. Refer to the Setting Up Forte Payments Device Handler – for Forte Checkout for details.
- In your button code, pass in the
swipe=EMV-1
parameter. This indicates that Forte Checkout should accept input from the V400c Plus. Refer to the Coding the Button section of the Forte Checkout integration documentation. - The Forte Checkout modal window displays a Read Card button. Once the button is clicked, Forte Checkout sends the amount to be collected to the device and the device will prompt the customer to present his/her card.
- IMPORTANT NOTE: For the terminal to wake up when initiating a transaction, the terminal should be connected to the computer (via the USB cable) and the device hander should be running before the terminal is started (or restarted). The terminal should be started (or restarted) every time the device handler is installed (or reinstalled) or the computer is started (or restarted).
- Once the customer presents the card, the V400c Plus reads the card, sends an authorization request to Forte, and then receives the authorization response:
- If the transaction is approved, the V400c Plus prints an EMV-compliant receipt and passes the authorization response message to Forte Checkout.
- If the transaction is declined, the V400c Plus displays a decline message and passes the decline response back to Forte Checkout, which displays the decline code and reason.
With this set up, receipt printing is only handled by the V400c Plus.
Integrating with Secure Web Pay Checkout - Semi - hybrid via USB
Refer to the Getting Started section before setting up your device. To set up your V400c Plus with Secure Web Pay (SWP) Checkout, complete the following steps:
- Download and install the Forte Payments Device Handler and the Verifone Unified Driver. Refer to the Setting Up Forte Payments Device Handler – for Secure Web Pay Checkout for details.
- In the button code, pass the parameter
pg_swipe=EMV-1
. will indicates that Secure Web Pay Checkout should accept input from the V400c Plus. - Once the modal window displays, Secure Web Pay Checkout will detect the V400c Plus connected to the PC.
- After device detection, Secure Web Pay Checkout will display the Read Card button. Once the button is clicked, the transaction details are sent to the V400c Plus.
- IMPORTANT NOTE.
For the terminal to wake up when initiating a transaction, the terminal should be connected to the computer (via the USB cable) and the device hander should be running before the terminal is started (or restarted). The terminal should be started (or restarted) every time the device handler is installed (or reinstalled) or the computer is started (or restarted). - Upon receiving the transaction message from Secure Web Pay Checkout, the V400c Plus will prompt the customer to present his/her card.
- Once the customer presents his/her card, the V400c Plus will communicate the transaction message to Forte and receive an authorization response:
- If the transaction is approved, the V400c Plus prints an EMV-compliant receipt (if receipt printing is enabled) and passes the response message to Secure Web Pay Checkout.
Secure Web Pay Checkout supports three receipt options for the customer:
- Print the receipt from the V400c Plus
- Print a Secure Web Pay-generated 8.5-inch receipt from the PC using parameter
pg_receipt=1
. - Print a 3.5-inch-wide receipt using a Star receipt printer by using parameter
pg_receipt=2
.
Integrating with Custom Applications
Merchants coding their own web or .NET native application for Windows OS to connect with the V400c Plus can choose the appropriate device handlers or write their own code to communicate with the device. For merchants using native, Windows-based POS applications, Forte recommends integrating your Verifone terminal using the Device Handler dynamic link library (DLL). Refer to Setting Up Forte Payment Device Handler – for Native Applications for details.
Merchants coding for other operating systems or using other development platforms will have to write their own code to connect to the device. The POS application can include any of the request parameters described in the Advanced Gateway Interface integration guide in the transaction message. Refer to the Hybrid Solution Specification for details.
Flow of events
- The V400c Plus begins in listening mode, waiting for a transaction message from the POS application.
- The screen displays a custom message.
- The POS application sends a VISA-1 framed transaction message to the V400c Plus through the USB port. See the Creating the Message section for more detail on formatting messages.
- Once the V400c Plus receives the data, it validates the message for the following:
- The minimum required fields,
pg_merchant_id
andpg_total_amount
, are present in the message. - The provided Merchant ID is a configured in the terminal.
- The minimum required fields,
- If the message is valid, the V400c Plus displays the total amount to the customer and prompts him or her to present the credit card.
- When he/she presents the card, the V400c Plus sends the authorization request to Forte and receives the authorization response:
- If the transaction is Approved, the V400c Plus prints a receipt (if receipt printing is enabled) and passes the response back to the POS application. If receipt printing is disabled, the merchant must create his/her own EMV-compliant receipt. Refer to the Formatting EMV-Compliant Receipts for Custom Applications section for instructions on creating an EMV-compliant receipt.
- If the transaction is Declined, the V400c Plus displays the decline message and passes the response back to the POS application.
- The V400c reverts to listening mode to receive the next transaction message.
Handling Convenience Fees
Merchants that are set up with convenience fees should handle the convenience fee calculation using one of the following options:
- Have the V400c Plus calculate the convenience fee. The V400c Plus calculates convenience fees based on the
pg_total_amount
value it receives in the transactions message. - The POS application calculates the convenience fee and sends it to the V400c Plus. Merchants also have the option to calculate convenience fees on the POS application (based on the total amount) and then send it to the V400c Plus using the
pg_convenience_fee
parameter in the transaction message
Creating the Message
The minimum fields required to wake up the terminal are pg_merchant_id
and pg_total_amount
. Merchants set up with convenience fees can choose to have the V400c Plus calculate the convenience fee or the POS application can be coded to send convenience fee to the terminal using the pg_conveninence_fee
field. The Advanced Gateway Interface integration guide provides information on calculating the convenience fee.
All request and response packets must be framed with the following Visa -1 Framing format: <STX>
message<ETX><LRC><LF>
. All messages must meet the following requirements:
- Start with STX (hex 0x02)
- End with ETX (hex 0x03) and an LRC. The LRC is the longitudinal redundancy check not including the STX but including the ETX. For information on calculating the LRC, click here. The following code snippet calculates the LRC:
private byte calculateLRC(byte[] b)
{
byte lrc = 0;
for (int i = 0; i < b.Length; i++){
lrc ^= b[i];
}
return lrc;
}
Sample Messages
The following snippet displays a sample of the minimum code needed to send a transaction from the POS application to the V400c Plus:
pg_merchant_id=123456|pg_total_amount=1.00|endofdata
The following snippet displays a robust code sample for sending a transaction from the POS application to the V400c Plus:
pg_merchant_id=123456|pg_total_amount=1.00|ecom_consumerorderid=12345
|pg_consumer_id=ABCDEFG~ecom_billto_postal_name_first=Jane|ecom_billto_postal_name_last=Doe|
ecom_billto_postal_street_line1=1234 Any St|ecom_billto_postal_street_line2=Apt 2
|ecom_billto_postal_city=Allen|ecom_billto_postal_stateprov=TX|ecom_billto_postal_postalcode=75013
|ecom_billto_online_email=jane.doe@gmail.com|pg_line_item_header=SKU,Price,Qty
|pg_line_item_1=021000021,45.00,2|pg_line_item_2=021000022,36.99,10|pg_line_item_3=021000023,27.50,7| endofdata>
Sending Messages via Web Applications
Merchants coding their own web application for Windows OS can opt to use the Forte Web Device Handler. When using the Web Device Handler, the merchant does not have to construct the full Visa-1 framed message. Instead the merchant can choose to call functions that would format the message and communicate with the device to send the request and then receive the response. More information can be found in the Setting Up Device Handler for Custom Web Applications section of this document
Merchants who are using different operating systems or merchants who want their own solution to interact with the V400c Plus can write their own code to format the message and send it to the terminal over the port.
Sending Messages via Native Applications
Merchants coding custom native applications can use the Desktop Device Handler. With the Desktop Device Handler, the merchant will not have to construct the message to be sent to the POS application. Instead the merchant can choose to call functions that would format the message and communicate with the device to send the request and receive the response. For more information, see Setting up Device Handler for Native Applications section.
Merchants using technologies other than .NET must write their own code to format the message, send it to the V400c Plus, and receive the response over the port.
Setting Up Device Handler
Device handler enables web and native applications to communicate with the V400c Plus by sending and receiving transaction data over a port. Forte offers two variants of the device handler: Web and Desktop DLL. The Web Device Handler must be installed and running for Forte Checkout and Secure Web Pay Checkout to connect to the V400c Plus. Merchants can also code their custom web applications to the Web Device Handler to connect to the V400c Plus.
The Desktop Device Handler enables a merchant's .NET application to connect to the V400c Plus. For more information on the Device Handler, see Using Device Handler.
Device Handler for Forte Checkout and Secure Web Pay Checkout
- Download the Forte Payments Device Handler from DevDocs.
- Run the .exe file.
- Once the installation is complete, perform the following steps:
- Open Windows Services
- Ensure that the Device Handler is running.
- Download the Verifone Unified Driver from DevDocs.
- Run the .exe file.
- Once the installation is complete, perform the following steps:
- Open Device Manager
- Ensure the Port is showing as “Mx Family POS Terminal (COM9)”.
Device Handler for Custom Web Applications
Merchants coding custom web applications to work with the V400c Plus on Windows OS can use Forte’s Web Device Handler by completing the following steps:
- Download the Forte Payments Device Handler from DevDocs.
- Run the .exe file.
- Once the installation is complete, perform the following steps:
- Open Windows Services
- Ensure that the Device Handler is running.
- Download the Verifone Unified Driver from DevDocs.
- Run the .exe file.
- Once the installation is complete, perform the following steps:
- Open Device Manager
- Ensure the Port is showing as “Mx Family POS Terminal (COM9)”.
- On your payment form page, add the following script:
<script type="text/javascript" src="https://s3.amazonaws.com/public.forte.prod/fpdh/handler.js"></script>
Simplifying IT
for a complex world.
Platform partnerships
-
AWS
-
Google Cloud
-
Microsoft
-
Salesforce
Services