Download / NETePay Options / NETePay Classic – Processors / Heartland Portico Host EMV / NETePay Heartland Portico Host EMV – HPH

NETePay Heartland Portico Host EMV - HPH

Please follow the steps below to complete your installation of NETePay Heartland Portico Host EMV – HPH

Step 1

Install Client Control

In order to communicate with this NETePay, your POS may use one of the following ActiveX controls depending on the integration method chosen by the POS developer. If you are unsure of which to install please contact POS technical support.

dsiEMVUS® 1.87

Release date: 09/09/2025

Datacap’s out-of-scope ActiveX control for NETePay supporting a variety of EMV-enabled hardware options.

For information on supported devices please see our Compatible devices page.

Release notes for v1.87

  1. The PAX whitelist is updated with InComm card BINs.
  2. CollectCardData will now collect clear card data IF the ISV passes in <ClearDataAllow>Allow</ClearDataAllow>.  Once clear card data has been collected, the ISV can use GetCollectedCardData to retrieve the data.  dsiEMVUS uses a new local whitelist that includes all BIN ranges in the current device whitelist. 
  3. A change is made for PAX so that the contactless icon does not disappear when switching forms.
  4. Manual Entry is now supported for CollectCardData for PAX devices.  To trigger Manual Entry, the <AcctNo> tag should be sent with a value of “Prompt”.  The PAX device will prompt for the account number, expiration date, Service Code (CVV) and ZIP.  Included in manual entry is support for <CVVRequired> and <ZipRequired> tags to require these fields and not allow them to be bypassed.  If tag <CVVRequired>Allow</CVVRequired> is included, the “SKIP” button is not shown on the form.  If tag <ZipRequired>Allow</ZipRequired> is included, the “SKIP” button is not shown on the form.
  5. For PAX, a new TranCode is added to allow an alpha string to be collected and returned.  The TranCode is “GetCustomPrompt”. Use the <Question> tag for the prompt. There is also an optional <QuestionTimeout> tag that can used to supply a reasonable timeout value in seconds.
    The response is returned in the <Answer> tag assuming you enter a string of characters and press Enter. If Cancel is pressed, then you receive a cancel response.
  6. The CancelRequest method is now allowed to cancel GetSignature for Ingenico Tetra.  
  7. When performing a CollectCardData using the VP3350, the <AccountSource> is now included in the data when swiping a card. 
  8. For a clear Ingenico Tetra device, the clear account number needed to be included in the PIN Entry command (31.) when manually keying an EBT transaction. Without including the account number, the 31. command returned 31.7. dsiEMVX then returned “No Useable PINBlock Found in Message”. When performing a CollectCardData using the VP3350, the <AccountSource> is now included in the data when swiping a card. 

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

OR

dsiPDCX® 1.98

Release date: 07/17/2025

Datacap’s ActiveX control for non-EMV transactions using NETePay and GIFTePay software that supports dozens of plug and play hardware options, including PIN Pads, Mag stripe readers, all-in-one touch terminals and contactless readers. dsiPDCX is included as part of the dsiEMVUS download, so this control only needs to be installed for non-EMV installs.

Release notes for v1.98

  1. For EBT transactions dsiPDCX now allows clear card data to be collected from encrypted devices.  This includes PAX, Ingenico Tetra and Verifone P400 devices.  dsiPDCX keeps a list of all of the EBT card BINs and allows those cards to be clear when processing EBT (Foodstamp or Cash).  
  2. If an ISV sends <FSABins>, this tag will be removed before passing the transaction on to NETePay. 

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

OR

DSIClientX® 3.86

Release date: 09/01/2011

Datacap’s long-standing in-scope ActiveX control for NETePay and GIFTePay software. Generally, DISClientX should only be used for legacy installs.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Looking for a older version?

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.37

NETePay Director

NETePay Director provides a simplified installation process with go-forward remote software updates.

Release date: 11/21/2022

  • NETePay is released following our PAX EMV device certification. 
  • NETePay supports the XML tag <CardNotPresent>Allow</CardNotPresent> to indicate that the card is not present for a manually keyed transaction. 
  • The latest libraries for Store and Forward and Local Batch Reporting are included.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Or download NETePay Heartland Portico Host EMV – HPH 5.07.37 (⚠ non-director installs do not support remote updates)

  • When applications are configured and running, the context menu now includes a new selection – Load Parameters (Stop/Start Director). The user can click one menu item to restart which will cause ePays to restart and reload parameters.
  • When a NETePay or GIFTePay window is opened, there are now four icons in the upper right corner that have the following functions.
    • View Merchant Parameters
    • PSCS
    • Email log
    • View log

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.36

NETePay Director

NETePay Director provides a simplified installation process with go-forward remote software updates.

Release date: 03/31/2021

  • The value of the InvoiceNo field is now sent to Portico in the “DirectMktInvoiceNbr” field for select Credit card transactions.
  • This version is built with the latest Store & Forward library (8.20). Version 8.20 includes a fix for Incremental Auth transactions when interwoven with multiple transaction sequences of PreAuth, Incremental Auth, Partial Reveral and PreAuthCapture. Each sequence is now forwarded in order, regardless of how the transactions were stored originally.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Or download NETePay Heartland Portico Host EMV – HPH 5.07.36 (⚠ non-director installs do not support remote updates)

  • When applications are configured and running, the context menu now includes a new selection – Load Parameters (Stop/Start Director). The user can click one menu item to restart which will cause ePays to restart and reload parameters.
  • When a NETePay or GIFTePay window is opened, there are now four icons in the upper right corner that have the following functions.
    • View Merchant Parameters
    • PSCS
    • Email log
    • View log

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.35

NETePay Director

NETePay Director provides a simplified installation process with go-forward remote software updates.

Release date: 08/13/2019

  • Support is added for the E-Commerce merchant category. When the merchant category is set to E-Commerce, only manually keyed credit cards should be processed. Each transaction is flagged as Card-Not-Present and includes the E-Commerce flag.
  • The Store and Forward library will not allow a stored transaction to be modified while transactions are being forwarded. All modifications should be performed prior to the forward.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Or download NETePay Heartland Portico Host EMV – HPH 5.07.35 (⚠ non-director installs do not support remote updates)

  • When applications are configured and running, the context menu now includes a new selection – Load Parameters (Stop/Start Director). The user can click one menu item to restart which will cause ePays to restart and reload parameters.
  • When a NETePay or GIFTePay window is opened, there are now four icons in the upper right corner that have the following functions.
    • View Merchant Parameters
    • PSCS
    • Email log
    • View log

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.34

NETePay Director

NETePay Director provides a simplified installation process with go-forward remote software updates.

Release date: 07/17/2019

  • Support is added for Ingenico Tetra devices enabled for Voltage PAN encryption. An EMV certification was recently completed including EMV contact and contactless transactions. Non-EMV certifications were complete for Retail, Restaurant, FSA and Hotel.
  • Support is added for EMV Debit. The choices for “EMV Support” now include “None”, “Credit Only”, “Credit and Swiped PIN Debit”, “Credit and Debit” and “Credit and Debit – Prefer Debit”.
  • Support is added for Hotel/Lodging. ISV’s support Lodging by sending new optional Lodging XML fields as part of currently supported transactions. No new TranCodes are added. Details will be added to our integration documentation for dsiPDCX and dsiEMVUS.
  • Support is added for Incremental Auth (IncrementalAuthByRecordNo) and Partial Reversal (PartialReversalByRecordNo). Heartland does not require a Partial Reversal because the host automatically performs a partial reversal when a transaction is captured for an amount less than the amount authorized. However, for consistency of integration, the ISV can send a Partial Reversal prior to a PreAuth Capture. Heartland allows an Incremental Auth only for Restaurant and Hotel merchant categories.
  • Store and Forward includes support for Incremental Auth and Partial Reversal transactions.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Or download NETePay Heartland Portico Host EMV – HPH 5.07.34 (⚠ non-director installs do not support remote updates)

  • When applications are configured and running, the context menu now includes a new selection – Load Parameters (Stop/Start Director). The user can click one menu item to restart which will cause ePays to restart and reload parameters.
  • When a NETePay or GIFTePay window is opened, there are now four icons in the upper right corner that have the following functions.
    • View Merchant Parameters
    • PSCS
    • Email log
    • View log

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.33

NETePay Director

NETePay Director provides a simplified installation process with go-forward remote software updates.

Release date: 02/07/2019

  • Support is added for “81” China Union Pay cards.
  • Support is added for Local Batch Inquiry.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Or download NETePay Heartland Portico Host EMV – HPH 5.07.33 (⚠ non-director installs do not support remote updates)

  • When applications are configured and running, the context menu now includes a new selection – Load Parameters (Stop/Start Director). The user can click one menu item to restart which will cause ePays to restart and reload parameters.
  • When a NETePay or GIFTePay window is opened, there are now four icons in the upper right corner that have the following functions.
    • View Merchant Parameters
    • PSCS
    • Email log
    • View log

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.32

NETePay Director

NETePay Director provides a simplified installation process with go-forward remote software updates.

Release date: 10/30/2018

  • Support for Ingenico EMV unattended devices is added. This includes the iUC285 and iUP250 devices. An EMV card brand certification was complete 10/24/2018.
  • Support for Ingenico EMV contactless transactions is added. This includes a Contactless Support parameter and an EMV Contactless CVM Limit parameter.
  • The Local Batch Reporting feature is enhanced to record information on declines and errors on a daily basis. The Local Batch Report Viewer now includes a new tab for Declines and Errors providing a way to view and print declines and errors. The information presented includes the time, the transaction status, the decline or error message, if the decline occurred when forwarding the transaction as part of store and forward, the card type, the transaction code, the account source, the purchase amount, the gratuity amount, the cash back amount, the invoice number, the reference number and the operator ID.
  • Support is added for IncrementalAuthByRecordNo and PartialReversalByRecordNo. Heartland does not require an integrator to perform a PartialReversalByRecordNo because they automatically reverse authorized funds when a transaction is captured for less than the amount authorized. For a consistent integration, ISVs should implement both IncrementalAuthByRecordNo and PartialReversalByRecordNo. Other payment services require the partial reversal prior to capture when the amount captured is less than the amount authorized. Certification was completed on 6/7/2018.
  • Support for an EMVPreAuth transaction is added.
  • Support is added for FSASaleByRecordNo and ReverseFSASaleByRecordNo.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Or download NETePay Heartland Portico Host EMV – HPH 5.07.32 (⚠ non-director installs do not support remote updates)

  • When applications are configured and running, the context menu now includes a new selection – Load Parameters (Stop/Start Director). The user can click one menu item to restart which will cause ePays to restart and reload parameters.
  • When a NETePay or GIFTePay window is opened, there are now four icons in the upper right corner that have the following functions.
    • View Merchant Parameters
    • PSCS
    • Email log
    • View log

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.31

NETePay Director

NETePay Director provides a simplified installation process with go-forward remote software updates.

Release date: 04/27/2018

  • The following changes are made related to store and forward processing.
    • The SAF_ForwardAll operation will now recover if communication failures occur during the forwarding process. An error will be returned along with the number of transactions that have completed forwarding. A subsequent SAF_ForwardAll will pick up where the previous one left off.
    • If there are no transactions to forward, a SAF_ForwardAll operation will now return SUCCESS along with zero totals.
    • The SAF Totals now include a count of Uncaptured PreAuth requests. All PreAuth transactions should be captured prior to forwarding stored transactions. There is no way to be paid for a forwarded PreAuth that was not captured.
    • There is a purchase amount limit parameter set on PSCS and a purchase limit sent in from the POS. The smaller of the two is compared to the transaction purchase amount. If the transaction purchase amount is less than or equal to the smaller of the two limits, then the transaction can possibly be stored offline. Otherwise, the transaction will go online.
    • There is a maximum stored transaction limit set on PSCS and a stored transaction limit sent in from the POS. The smaller of the two is compared with the current number of stored transactions. If the addition of one more transaction would keep the number of stored transaction under or equal to the smaller of the two limits, then the transaction can possibly be stored offline. Otherwise, the transaction will go online.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Or download NETePay Heartland Portico Host EMV – HPH 5.07.31 (⚠ non-director installs do not support remote updates)

  • When applications are configured and running, the context menu now includes a new selection – Load Parameters (Stop/Start Director). The user can click one menu item to restart which will cause ePays to restart and reload parameters.
  • When a NETePay or GIFTePay window is opened, there are now four icons in the upper right corner that have the following functions.
    • View Merchant Parameters
    • PSCS
    • Email log
    • View log

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.30

NETePay Director

NETePay Director provides a simplified installation process with go-forward remote software updates.

Release date: 02/01/2018

  • Support added for NETePay 5 Director.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Or download NETePay Heartland Portico Host EMV – HPH 5.07.30 (⚠ non-director installs do not support remote updates)

  • When applications are configured and running, the context menu now includes a new selection – Load Parameters (Stop/Start Director). The user can click one menu item to restart which will cause ePays to restart and reload parameters.
  • When a NETePay or GIFTePay window is opened, there are now four icons in the upper right corner that have the following functions.
    • View Merchant Parameters
    • PSCS
    • Email log
    • View log

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.07.20

NETePay Heartland Portico Host EMV - HPH 5.07.20

Release date: 12/11/2017

  • PA-DSS 3.2
  • Support is added for IDTech devices with AES DUKPT P2PE.
  • Store and Forward is added. This is an optional feature that must be enabled via PSCS and requires integration changes.
  • Pay At The Table is added. This is an optional feature that must be enabled via PSCS and requires integration changes.
  • Local Batch Reporting data storage is added. This is an optional feature that must be enabled via PSCS. Data can be viewed using the Local Batch Report Viewer.
  • Support is added for the latest Auto-Update functionality. With 5.07.20, updates can occur to new versions of the same application.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.06.11

NETePay Heartland Portico Host EMV - HPH 5.06.11

Release date: 05/04/2016

A new “EMV Cardholder Verification” parameter is added to this NETePay where the choices are “All CVMs”, “Signature” or “None”. “All CVMs” is the default on PSCS and includes Online PIN, Offline PIN, Signature and No CVM. This setting in NETePay determines the “EMV Terminal Capabilities” setting stored in the PIN pad during an EMV Parameter Download operation. If this parameter is changed in NETePay, then an EMV Parameter Download should be run at each workstation where a PIN pad is attached.

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.06.10

NETePay Heartland Portico Host EMV - HPH 5.06.10

Release date: 03/14/2016

Enhanced to support US EMV transactions via the Ingenico iSC250 w/ Heartland Voltage and RBA 16.02 (dsiEMVUS v1.03 required)

RealTimeSubstantiation field added for FSA requests

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

Step 2

Install NETePay Heartland Portico Host EMV - HPH 5.05.05

NETePay Heartland Portico Host - HPH 5.05.05

Release date: 03/26/2015

Supports Heartland’s host-based Portico platform which adds a litany of features including point to point encryption, multi-use tokens and host-based tip adjustments. Also supported is TLS 1.1 or higher (SSLv3 and TLS 1.0 are not supported).

Windows11 Pro / 10 Pro / Server 2019 / Server 2016

End-User License Agreement (EULA)

All Datacap software is provided ‘as-is’. Datacap makes no warranties, expressed or implied, as to merchantability or fitness for a particular purpose. Use of Datacap software is defined in an End-User License Agreement (EULA) included with each product and is presented for review during software installation.

To view the full EULA, click here.