Please follow the steps below to complete your installation of NETePay BB&T NETePay Host - VRH 5.08.50 Rental

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.69

Release date: 04/13/2023

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.69

  • Support of the Ingenico Self/3000 unattended device for Hosted. This device supports credit only, No CVM, chip, contactless and swipe.
  • Whitelist BIN range 100000-199999 for IDTech VP3300. The whitelist is loaded during an EMVParamDownload.
  • For PAX devices for Return transactions, added 0xCB tag to EMVBeginContactTxn to trigger a Full EMV flow. Coupled with PAX PxRetailer version 2.00.45 or above, causes the EMVContinueContactTxn to perform properly allowing for PIN entry and a response with all EMV tags. A Full EMV flow is important for Returns since they now go online to the card issuer.
  • For PAX insertion reader devices (A60, Aries6, Aries8), using PxRetailer 2.00.47 and above, turns off MSR "inserted" and "removed" statuses allowing for a much more reliable magstripe read. PAX provided a new system variable – PXR.MSRHYBIRD, allowing these statuses to be turned off.
  • Support for <FSAWithLookup> amount for EMVSale transactions allowing FSA/HSA chip cards to be processed successfully. This feature is supported for Hosted only and currently only when the backend processor is Rapid Connect. For an EMVSale transaction, the integrator can pass in the amount of FSA eligible items in a new tag <FSAWithLookup>. The gateway will use a BIN lookup to determine if the card presented is an FSA or HSA card. If it is, the TranCode will be changed from EMVSale to EMVFSASale and the <FSAWithLookup> amount will replace the <Purchase> amount. All other amounts will be removed. The Rapid Connect MM NETePay now supports the TranCode EMVFSASale. If the card is not an FSA or HSA card, then the transaction will be sent for processing unchanged. The integrator can also send any of the optional FSA amounts for prescription, dental, vision, or clinical. The integrator should inspect the TranCode returned and the amount authorized.
  • Support for EMVSaleWithSplit transactions. EMVSaleWithSplit is a new transaction (new TranCode) supported for Hosted. This transaction is expected to be used in the government space where a cardholder pays a utility bill in person and is also charged a separate fee to a separate service organization. It provides a way to process a normal EMV Sale transaction along with a separate, second transaction for a "split fee" amount. New request fields include <SplitMerchantID1>, <SplitFee1> and <CustomAmountFormat>. The <SplitMerchantID1> is the Hosted Merchant ID value that should be used to process the split fee payment. <SplitFee1> is the amount of the split fee payment. <CustomAmountFormat> is a field that contains a display message to be shown to the cardholder on a PAX PIN pad showing the amount of the EMVSale and the amount of the split fee. An EMVSaleWithSplit example is below. The receipt print data is for the primary transaction. There is currently no print data produced for the secondary "split" transaction. The primary transaction is processed with the card data collected from the cardholder. The secondary transaction is processed with manual card data from a token.

The value of the <CustomAmountFormat> tag maps to a variable contained in the latest PAX forms package. dsiEMVUS checks the PAX forms package version to know if the variable exists before populating the variable for amount confirmation and when displaying the form to collect card data (Please Insert, Swipe or Tap Card). The <CustomAmountFormat> tag includes the following predefined elements …

  1. #PAYMENT# - The amount of the payment (Purchase + Gratuity + Cash Back).
  2. #N# - A new line.
  3. #FEE1# - The amount of SplitFee1.

An example of the CustomAmountFormat sent on an EMVSaleWithSplit is …

  • <CustomAmountFormat>Payment Amount: $#PAYMENT##N#Fee Amount: $#FEE1#</CustomAmountFormat>

An example of the CustomAmountFormat sent on an EMVSale is …

  • <CustomAmountFormat>Sale Amount: $#PAYMENT#</CustomAmountFormat>

For an EMVSaleWithSplit transaction, it is very important for the ISV to supply the CustomAmountFormat tag that includes both #PAYMENT# and #FEE1#.

Microsoft Windows 11 Pro / 10 Pro / Server 2019 / Server 2016

OR

dsiPDCX® 1.88

Release date: 04/13/2023

Datacap’s out-of-scope ActiveX control for 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.

Release notes for v1.88

  • For PAX insertion reader devices (A60, Aries6, Aries8), using PxRetailer 2.00.47 and above, turns off MSR "inserted" and "removed" statuses allowing for a much more reliable magstripe read. PAX provided a new system variable – PXR.MSRHYBIRD, allowing these statuses to be turned off.
  • For the latest PAX forms package, the STR.AMOUNT_TEXT variable is cleared when displaying the “swipe screen”.
  • If an ISV performs a SecureDevice Init for the IDTech VP3300, then the whitelist BIN range 100000-199999 is loaded.
Microsoft Windows 11 Pro / 10 Pro / Server 2019 / Server 2016

OR

DSIClientX® 3.86

Release date: 01/05/2023

Datacap’s long-standing in-scope ActiveX control for NETePay and GIFTePay software.

1/5/23 - New DSIClient test application released to remove username from the usertrace field.

Microsoft Windows 11 Pro / 10 Pro / Server 2019 / Server 2016
Step 2 - Install Administrative tools (optional)
Local Batch Report Viewer

Release date: 05/11/2020

Local Batch Report Viewer can be used to view the locally stored batch report of Host based NETePay who support support this feature and have it enabled via PSCS.

Release notes for v1.03

  • Fix for an issue which prevented errors from the open batch being shown in the decline/error tab.
Microsoft Windows 11 Pro / 10 Pro / Server 2019 / Server 2016
Step 3 - Install NETePay BB&T NETePay Host - VRH 5.08.50 Rental

This NETePay is available via the NETePay 5 Director which provides a simplified installation process and go-forward automatic software updates. NETePay 5 Director is recommended but if needed the classic installation process is still available by clicking Download as usual.

To learn more about the NETePay 5 Director click here.

Release date: 01/25/2023

  • New features added for eCommerce include
    • Support for Level III data. Level II data must be sent when Level III is provided.
    • Card On File support is added for Recurring and Installment transactions.
    • ApplePay and GooglePay in-app support is added.
  • Support is added for Payment Facilitators (PayFac) for Hosted. For a PayFac sub-merchant, additional ID and demographic information can be added to a stage file on PSCS. This information will be included in host messaging for all payment requests.
Microsoft Windows 11 Pro / 10 Pro / Server 2019 / Server 2016