Below you will find frequently asked questions to EC-Linx, Payment WorkSuite's web-service interface.
- Does EC-Linx provide real-time processing?
- How do I set up EC-Linx on my account?
- How do I reset my EC-Linx web service username password?
- Why am I getting a permission denied error when I submit my web service call?
- Why am I receiving a “ValidationFailed” FailureReason when I submit my web service call?
- Are there different coding samples other than .NET in the EC-Linx Web Service Interface document?
- I made a web service call to process a transaction; why can’t I see the transaction on the View Transactions page?
- Is it mandatory that I submit Level-3 data when running an Authorize transaction type?
- Can I add a large dynamic or static IP Address range to my account IP Address Whitelist?
Does EC-Linx provide real-time processing?
EC-Linx is designed for real-time transaction submissions and responses.
EC-Linx allows server-to-server, real-time credit card authorizations via the Internet. It can be integrated directly to your e-commerce application, enterprise resource planning system, networked point-of-sale (POS) or back-office finance system.
Please note that the transaction settlement process is not completed real-time. Transaction settlement communications between 3DSI and your merchant processing platform occur in a scheduled batch process each night.
How do I set up EC-Linx on my account?
To begin the process, send a request to our Customer Support Team (at PaymentWorkSuite@3dsi.com) to inquire about adding EC-Linx to your Payment WorkSuite® account services. Since it does require a technical effort on your side, we’ll send a copy of the EC-Linx API (coding specifications) for your review and consideration.
After reviewing the API, if you are ready to move forward, we require the following:
1. A written confirmation (an email is sufficient) from the listed managerial account contact confirming the addition of the EC-Linx product to your services and acknowledging that 3DSI may assess a non-recurring integration fee (one instance per active merchant account/terminal). Please note that whether you are assessed this fee directly by 3DSI or through your merchant services provider will depend on the billing arrangement for your account.
2. If you have multiple merchant accounts and/or locations/terminals boarded with 3DSI, please confirm the location and merchant account number(s) for which the services will be activated for. Unless otherwise notified, we will assume that all locations/terminals will need the services and bill accordingly.
3. Provide a primary Technical Contact for the integration efforts. We require the following information to begin the integration and testing process:
- Technical Contact Company (if different from yours)
- Technical Contact Name
- Technical Contact Phone Number
- Technical Contact Email Address
Once your Technical Contact has been identified, we will send the EC-Linx coding specifications (API) and information about the testing process and test account access information to that individual.
Your Technical Contact will then work with the 3DSI Technical Support Team to complete the certification process to use EC-Linx in production.
How do I reset my EC-Linx web service username password?
A listed managerial or technical contact on the account will need to send an email to firstname.lastname@example.org to trigger a ticket request to have the EC-Linx web service username password reset. The new password will be sent in an encrypted email to the listed contact email address on file.
Why am I getting a permission denied error when I submit my web service call?
If you are receiving a Permission Denied error response, please first verify that the access credentials that you are passing are accurate. If the credentials appear to be valid, please send an email to email@example.com to trigger a ticket request for a research effort into the issue. The 3DSI Technical Support Team will need to research the error as it could indicate incorrect access information or a permissions issue. For security purposes, please do not provide any production password information in your request.
Why am I receiving a “ValidationFailed” FailureReason when I submit my web service call?
If the FailureReason property is returned as "ValidationFailed", you should examine the ValidationFailures array that is returned for more information about what caused the problem. You can also provide us with a copy of the strings returned in the ValidationFailures array in an email to firstname.lastname@example.org to trigger a ticket request so that we can review what caused the failure and provide options to correct it.
Are there different coding samples other than .NET in the EC-Linx Web Service Interface document?
We currently have Ruby and PHP samples that we can also share. These libraries are located in a secure section of our Help Center. Please email email@example.com to open a ticket with our 3DSI Technical Support Team in order to gain access.
I made a web service call to process a transaction; why can’t I see the transaction on the View Transactions page?
There are several reasons why a transaction might not appear on the View Transactions page:
- The Client Code, Username, Password combination you are passing is invalid.
- Please ensure that you are using the correct credentials when making a web service call to the interface.
- The Merchant, Location and Terminal Hierarchy is invalid.
- If you have multiple merchant accounts and/or locations/terminals boarded with 3DSI, please confirm that you are using the correct hierarchy to process the transaction successfully.
- There is a problem with the XML data that you are submitting to the interface.
- This can be due to a Validation Failure or another discrepancy within the code. We recommend that you review the FailureReason property within the response XML data for information about why the transaction may have failed. Please also feel free to forward a copy of the response XML data to Integration@3DSI.com for our Technical Support Team to assist in your review. If you are supplying live [production] XML submission data, make sure that you remove any sensitive information from the submission before sending it in your email. You should never include your web service password, the full credit card number, or the CSC value in your open communications to us.
Is it mandatory that I submit Level-3 data when running an Authorize transaction type?
You are not required to provide full Level-3 data at the time that you submit an Authorize transaction type. However, you should provide at least the Address Verification Service (AVS) billing address information and if available, the Card Security Code (CSC) during the initial authorization submission. You can provide the rest of the Level-3 specific detail during the [secondary] Capture stage. We highly recommend that you do provide full Level-3 detail during the Capture transaction submission to help you best qualify for the lowest possible interchange rates.
Can I add a large dynamic or static IP Address range to my account IP Address Whitelist?
We do not recommend that you add a large IP range to an account whitelist. A large dynamic or static IP Address range would not be beneficial since it defeats the purpose of having a small set of designated and easily monitored system connections. For security best practices, we suggest that you provide 2-3 designated IP Addresses to make the secure connection between servers.