Documente Academic
Documente Profesional
Documente Cultură
Guidelines
EVO NGTrans (aka EVO Domestic) BCP Adaptor
Contents
Overview.................................................................................................................................................................. 3
Duplicate Transaction Detection and Processing.....................................................................................................5
PIN Debit Processing................................................................................................................................................6
EBT Processing.........................................................................................................................................................6
Required Fields for EBT Processing.......................................................................................................................6
Recurring Bill Payment Processing...........................................................................................................................7
Installment Payment Processing..............................................................................................................................7
Visa Debt Repayment Program................................................................................................................................8
Digital Wallet Processing..........................................................................................................................................8
Partial Reversal Processing.......................................................................................................................................8
3-D Secure Processing..............................................................................................................................................9
Verified By Visa (VbV/VPAS).................................................................................................................................9
MasterCard Secure Code (MCSC/UCAF)...............................................................................................................9
Multiple Partial Capture Processing.......................................................................................................................10
Verify() Processing..................................................................................................................................................10
CVV/CID Processing................................................................................................................................................11
Partial Approvals (Partial Authorization)................................................................................................................11
Purchase Card - Level 2..........................................................................................................................................11
Purchase Card – Level 3 (Line Item Detail).............................................................................................................12
Order Update Processing.......................................................................................................................................13
ReportingData/Reference Truncation....................................................................................................................13
Prepaid Card Final Balance.....................................................................................................................................13
PAN Tokenization...................................................................................................................................................13
End of Day..............................................................................................................................................................14
EMV Processing......................................................................................................................................................15
EMV Receipt Requirements................................................................................................................................15
The EVO NGTrans Domestic BCP adaptor supports Managed (host capture) processing.
Either Track 1 or Track 2 Data is supported for Credit swiped transactions. Track 2 Data is supported for PIN
Debit and EBT transactions.
As of January 2018 (.29 release) all transactions should include
BankcardTransaction/TenderData/TenderType. This field is required in order for EBT transactions to process
correctly, but all transactions should include the field due to EBT and EMV support. Credit EMV transactions with
a PIN will not process correctly unless this field is set. Rules will not be added for this requirement in order to
continue backward compatibility for existing customers that are not using EBT or EMV processing. All new
customers must be instructed to populate this field.
Credit = “ProcessAsCredit”
PIN Debit = “ProcessAsPinDebit”
EBT = “ProcessAsEBT”
EBT Processing
EBT processing is supported by NGTrans for the Retail industry and may be used for SNAP (Supplemental
Nutrition Assistance Program or food stamp) or cash purchases. Each type of purchase must be separate, SNAP
and cash may not be combined in a single transaction.
Supported transactions are:
AuthorizeAndCapture() – SNAP purchase / SNAP voucher purchase / cash purchase with or without cash
back
ReturnUnlinked() – SNAP return / SNAP voucher return (cash purchase returns are handled as cash
returns by the retailer; no transaction is submitted against the card)
Undo() – voids either AuthorizeAndCapture() or ReturnUnlinked() transactions
QueryAccount() – returns the EBT card balances for both SNAP and cash benefits
SNAP purchase, cash purchase, SNAP return and balance inquiry transactions always require both a PIN and key
serial number. These transactions may be keyed or swiped, but the PIN and key serial number are always
required, regardless of entry mode. ReturnById() is not supported due to this PIN/KSN requirement.
SNAP voucher purchase and voucher return transactions are similar to credit force post transactions. When a
processing system is down, EBT customers may request a voucher to use in place of their EBT card. Customer
service at the retailer will call the issuing bank for approval then issue the customer a numbered voucher,
writing the issuer’s approval code on that voucher. The customer then presents the voucher for their SNAP
purchase. These transactions will always be keyed, must include the voucher number and the approval code,
and will never include a PIN or key serial number.
Cash back may only be used with cash purchases. SNAP purchases do not support cash back.
EBT cards do not currently include chips; therefore EMV processing is not included.
It is up to the card issuer to manage cardholder balances. Balances may or may not be returned on purchase
and return transactions, based on issuer behavior.
Verify() Processing
Each card issuer decides which fields are required for verification. If possible, include both the PostalCode and
Street for the best verification results. Verify() may also include CVV/CID data.
American Express requires both postal code and address for Verify() transactions. If either field is missing, the
transaction will be declined.
CVV/CID Processing
Merchant must sign up for American Express CVV program before values will be verified.
CVV is required on all Discover keyed transactions. Transactions that do not provide this value may be
surcharged depending on the Discover Merchant Agreement.
ReportingData/Reference Truncation
EVO NGTrans will accept up to 17 upper or lower case letters, numbers or spaces in this field. No special
characters are allowed. In order to allow merchants to send any data they choose in this field, EVO Snap* will
remove any special characters that exist and report the last 17 characters of the string if it is longer. For
example: PO-12345678901234567890 will send 45678901234567890 to NGTrans; ABC_123/R1C will send
ABC123R1C to NGTrans. The value sent to NGTrans will be returned to the merchant in the
BankcardTransactionResponse/Reference field.
EMV Processing
NGTrans supports EMV transactions for both Credit and PIN Debit processing. All EMV Data must be translated
from binary and submitted in HEX format.
Track 2 Data is required with EMV Data.
ApplicationData/ReadCapability must be set to “MSRKeyICC”, “MSREMVICC”, “Chip”, “EMVICC”, or
“ContactlessChip”.
BankcardTransactionDataDefaults/EntryMode must be set to “ChipReliable”, “ContactlessMChipOrSmartCard”,
“ChipTrack2DataFromRFID” or “ChipUnreliable”.
BankcardTransaction/TransactionData/CardholderAuthenticationEntity may be set to “ICC”.
ApplicationData/EMVTerminalData/CardDataOutputCapability may be set to “ICC”.
Offline EMV transactions must be uploaded the next time the terminal goes online. Authorizations must include
the terminal assigned approval code in BankcardTransaction/TransactionData/ApprovalCode. These
transactions are considered “force post” transactions and must be submitted for settlement. All other relevant
transaction data must also be present.
EMV PIN processing is now supported for QueryAccount(), Verify(), Authorize() and AuthorizeAndCapture().
BankcardTenderDataPro/TenderData/CardSecurityData/PIN,
BankcardTenderDataPro/TenderData/CardSecurityData/KeySerialNumber and
BankcardTenderDataPro/TenderData/CardholderIdType = “PIN” must be included for all Chip and PIN
transactions. All EMV transactions that include a PIN must include the
BankcardTransaction/TenderData/TenderType field in order to process correctly without errors.
Credit = “ProcessAsCredit”
PIN Debit = “ProcessAsPinDebit”
An Undo transaction must be sent if the chip declines a transaction that was approved by the host.
BankcardTransaction/TransactionData/UndoReason should be set to “SuspectMalfunction” for these reversals.
INVALID ESTABLISHMENT ID
114 INVALID EST ID NO *.40
(FCS OR SE)
115 LOST CARD LOST CARD NO *.41
116 INSUF FUNDS INSUFFICIENT FUNDS NO N/A
INVALID MERCHANT
135 INVLD MER CFG NO *.57
CONFIGURATION