Please follow the steps below to complete your installation of NETePay Datacap EasyCheckout 1.09

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
Step 2 - Install NETePay Datacap EasyCheckout 1.09

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: 12/14/2022

Support is added for a "non-cash adjustment" that an ISV can include as part of an electronic payment. Implementation is the same as dsiEMVUS. This new fee must be included in the purchase amount supplied by the ISV for an authorization. For receipt formatting, the ISV must also provide the adjustment amount in a new tag <PaymentFee>. This will allow the fee to be broken out on the receipt that is built by EasyCheckout. The ISV can also supply the description of the fee by providing the new tag <PaymentFeeDescription>. If the description is not provided, then "PAYMENT FEE" will be used as the description for the fee on the receipt. The value of <PaymentFee> is also passed through to NETePay, but all NETePays today ignore this new tag. This is one reason why the ISV must include the fee in the purchase amount provided.

As an example, if the purchase amount with tax is $20 and the fee is $1.50, then 21.50 must be provided in the <Purchase> tag. The <PurchaseFee> tag would be provided with 1.50. And the value of the <PurchaseFeeDescription> in this example is "NON-CASH ADJ".

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