Sending Transaction Request
Before sending any requests to the viaConex server, you will need the following Elavon-assigned credentials. These credentials should be sent in the header for all transaction requests.
Application_ID
- 8 digit alpha-numeric value, provided by your Solution EngineerTerminal_ID
- 22 digit numeric value, provided by your Solution EngineerRegistration Key
- NOVA_PORTAL_FAKE_KEY
The steps to successfully send a request to the viaConex server are in the following format:
Open up a socket to
http://certgate.viaconex.com/
.The Production Host is
http://prodgate.viaconex.com/
.Create a viaConex-formatted request message.
info_outlinenote
Only use Elavon-approved (allowed) card account numbers to test your integration. Refer to Test Cards for a complete list of card account numbers that are allowed for Elavon’s test systems. Using card account numbers not allowed for Elavon’s test systems will return the INVALID CARD authorization response message.
Send the request message as an HTTPS POST to the
/cgi-bin/encompass4.cgi
URL.Wait for the response to the submitted request.
Parse the response sent back from Elavon.
For multi-step transactions, such as Terminal-Based Settlements or Host-Based Echo messages, go back to step 2 and send the next transaction in the sequence. Repeat until the process is complete.
For single-step transactions, the host will close the socket when complete.