Vantiv Interface Parameters

The parameters in the table below are defined on the Interface Parameter Maintenance screen for the Vantiv (Litle) payment handler:

Parameter Name

Default Value

Description

ACCOUNT_VERIFICATION_ERROR

209,340

List of error codes for account verification request upon receiving which, system will authorize one dollar and immediately void the transaction if authorization is successful.

ALLOW_CHANGES_TO_CREDIT_CARD_PROFILE

ALWAYS

Must be equal to one of the following three values: "ALWAYS", "NEVER", "BEFORE EXPIRATION".

ALLOW_EXPIRATION_DATE_CHANGE

Y

If the value for this parameter is "N", then the expiration date of credit cards cannot be changed.

BILLING_ADDRESS_REQUIRED

N

If the value for this parameter is "Y", then the billing address fields are marked as required. Set "N" to mark them optional.

CREDIT_CARD_PROFILE_VALID_PERIOD

ALWAYS

Must be equal to either the number of days a token is valid or "ALWAYS".

DECLINE_ERROR

HARD DECLINE

The purpose of this parameter is if the error code (or in case of Vantiv, the error type) is HARD DECLINE, the settlement process (CCP610) will reverse the financials or receipt. The idea is that we already have an authorization and if for some reason settlement fails (due to network issues or any SOFT DECLINE) you don’t want to reverse the financials as the authorization may settle in the next run of CCP610.

 

·       HARD DECLINE: Response Type Hard Decline.

·       SOFT DECLINE: Response Type Soft Decline.

·       REFERRAL: Response Type Referral.

·       N/A: Response Type Not Applicable.

FOLLOW-ON CREDIT PERIOD

355

Follow-on Credits are performed by referencing the original Authorization information stored in the Payment Handler database. Enter the number of days your Payment Handler stores the original sale information here.

HOST URL

https://payments.vantivcnp.com/vap/communicator/online

Enter the host URL used to authorize a transaction from the VANTIV Production Server.

HOST URL TEST

https://payments.vantivprelive.com/vap/communicator/online

Enter the host URL used to authorize a transaction from the VANTIV TEST Server.

KNOWN HOSTS FILE

C:\Litle\dll\knownhosts

This parameter has not yet been implemented and will be used in a future release.

LOG FILE

Null

If the PRINT XML parameter is set to "True", enter the full path of the log file where Vantiv API logs all the requests from the Application service, which is used for debugging transactions.

LOG FILE TRS

Null

As of 7.6.2, if the PRINT XML TRS parameter is set to "True", enter the full path of the log file where Vantiv API logs all the requests from the TRS service, which is used for debugging transactions.

NEUTER ACCOUNTNUMBERS

True

Specifies whether the card number will be neutered in the log file. If this parameter is set to "true", then credit card numbers will not be written to that log file; instead it will put xxxxxxxx.

Neuter credit card means that only the last 4 digits of the account number is stored in the file. This only comes into play if logging is enabled

ONLINE BATCH PORT

Null

This parameter has not yet been implemented and will be used in a future release.

ONLINE BATCH PORT TEST

15000

This parameter has not yet been implemented and will be used in a future release.

ONLINE BATCH URL

payments.vantivcnp.com

This parameter has not yet been implemented and will be used in a future release.

ONLINE BATCH URL TEST

payments.vantivprelive.com

This parameter has not yet been implemented and will be used in a future release.

PAYMENT HANDLER SERVER

TEST

Options: SANDBOX / TEST / PRODUCTION; Enter PRODUCTION to get the authorization from the payment handlers Post-Live server, TEST from the Pre-Live Server and SANDBOX  to use the simulator that provides a basic interface for functional level testing.

PRE_SETTLED_ERROR_CODE

361

The authorization for this transaction is no longer available. Either the authorization has already been consumed by another capture, or the authorization has expired.

PRE_SETTLED_PROCESSOR_DECLINE_ERROR_CODE

Null

List of comma separated processor response codes upon receiving in combination with PRE_SETTLED_ERROR_CODE, system will treat the settlement request as rejected and will proceed with reversal of receipt.

PRINT XML

True

Enter true or false. This parameter is used for debugging. If you want to log Vantiv information through the Application service, set this parameter to "True" and also provide a valid path (could be a shared location or an actual path) for the Log File parameter.

PRINT XML TRS

False

As of 7.6.2, enter true or false. This parameter is used for debugging. If you want to log Vantiv information through the TRS service, set this parameter to "True" and also provide a valid path (could be a shared location or an actual path) for the Log File TRS parameter.

PROXY PORT

Null

Enter the proxy port if the interface server is inside a firewall and the return message could not reach the server.

PROXY URL

Null

Enter the proxy URL if the interface server is inside a firewall and the return message could reach the server.

REJECTED_AVS_RESULT_CODES

12,13,29

Enter AVS result codes for which the transactions will be rejected (e.g., 12, 13, 20).

REJECTED_CVV_RESULT_CODES

N

Enter CVV result codes for which the transactions will be rejected (e.g., N, S).

REQUEST DIRECTORY

C:\Litle\

Enter the location to which the output file that is generated by FAR680 should be saved. It is from this location that the system uploads to the Vantiv server.

RESPONSE DIRECTORY

 

As of 7.6.2, specifies the response directory path on the TRS server, which is used to download the response files from VANTIV.

SFTP HOSTKEY

 

As of 7.6.2, specifies the SshHostKeyFingerprint for authentication SFTP server.

SFTP TEST HOSTKEY

 

As of 7.6.2, specifies the SshHostKeyFingerprint for authentication TEST SFTP server.

SFTP URL

payments.vantivcnp.com

Enter the SFTP URL for the VANTIV Production Server

SFTP URL TEST

payments.vantivprelive.com

Enter the SFTP URL for the VANTIV TEST Server

TRANSACTION TIMEOUT

65

Enter the transaction timeout in seconds.