XiPay AND XiSecure Tester

There are two utilities provided with PAS, XiPayNetTester and XiSecureNetTester that are utilized to test your authentication to the Web Services in Paymetric's data center as well as basic authorization and encrypt/decrypt functionality. When using the PAS GUI, these utilities are called when you perform Validation (clicking the or buttons – the first icon being the selected Program ID, the second being all configured Program IDs).

These utilities can be run from a command line or via the GUI Validation buttons on both Windows and RHEL. If you perform XiPay Testing from the GUI, it performs a Ping operation to the XiPay Web Service for any given XiPay Program ID (Auth, Settle, and Void).

For XiSecure Program ID type, it performs an Encrypt operation. To perform a basic Authorization or Decrypt operation, run the Testers from the command line. See below for more information.

XiPayNetTester

The XiPayNetTester utility allows you to send either a basic Authorization or Ping operation to the XiPay Web Service to verify that your credentials authenticate properly and/or that a response is received. From the Web GUI, only a Ping operation is performed for the Program IDs.

Run XiPayNetTester from the command line to test a basic Authorization response. The tester contains basic default payload information that is used for the authorization test.

Command line syntax

XiPayNetTester --progid <progidvalue> --gateway <gatewayhostvalue> --operation <1> or <11>

Where:

  • progidvalue = The Auth Program ID

  • gatewayhostvalue = The gatewayhost value for the Auth Program ID

  • Operation Number 1 = Authorization

  • Operation Number 11 = Ping

For the Authorization Operation, you should receive a StatusCode '100' and a value for AuthorizationCode if successful. If StatusCode is a negative number and/or AuthorizationCode is blank, the test failed.

For Ping Operation, you should receive a StatusCode '400' and a Message populated with data. If no StatusCode is returned, the test failed.

XiSecureNetTester

The XiSecureNetTester utility allows you to send either an Encrypt or Decrypt operation to the XiSecure Web Service to verify your client certificate authenticates properly and you can encrypt or decrypt card numbers. From the GUI, only a Encrypt operation is performed for the XiSecure Program ID. Run XiSecureNetTester from the command line to test the Decrypt operation.

Command line syntax  

XiSecureNetTester --progid <programid> --gateway <gatewayhost> --encrypt 4111111111111234

XiSecureNetTester --progid <programid> --gateway <gatewayhost> --decrypt -E803-1234-2000000000000J  

Where:

  • progidvalue = The Auth Program ID

  • gatewayhostvalue = The gatewayhost value for the Auth Program ID

  • encrypt = Has card number supplied

  • decrypt = Has token supplied

For the Encrypt Operation, you should receive a token back for the card number in the response.

For the Decrypt Operation, you should receive a credit card number back in the response.

Encrypt multiple card numbers at once

For Windows users, you can set the environment variable XISECURENET_RFC_TESTER_COUNT=value where value is a given number to submit multiple credit cards in a single test. The credit cards will have sequential numbers starting with 4111111111110000 up to the defined number of cards you set in the environment variable.

For Linux users, you can set the environment variable XISECURENET_RFC_TESTER_COUNT=value where value is a given number to submit submit multiple credit cards in a single test. The credit cards will have sequential numbers starting with 4111111111110000 up to the defined number of cards you set in the environment variable. This would be performed before executing the XiSecureNetTester.exe.

The syntax to set the environment variable would be as follows:

XISECURENET_RFC_TESTER_COUNT=value

export XISECURENET_RFC_TESTER_COUNT

If sending multiple credit card numbers for encrypt, do not include the --encrypt parameter in the XiSecureNetTester command line. For example, on Linux:

XiSecureNetTester --progid <programid> --gateway <gatewayhost>

If running on Windows, you will need to include the .exe in the command line as follows:

XiSecureNetTester.exe --progid <programid> --gateway <gatewayhost>

Additional testing

You can use SOAP UI third party tool to perform further detailed testing. Work with your Implementation Consultant for assistance with this effort.