Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
support:troubleshooting [2020/05/26 13:45]
branko
support:troubleshooting [2021/05/04 12:45] (current)
branko
Line 23: Line 23:
 <​li><​a href="#​18">​What do I need to start testing?</​a></​li>​ <​li><​a href="#​18">​What do I need to start testing?</​a></​li>​
 <​li><​a href="#​19">​What is the payconfig file?</​a></​li>​ <​li><​a href="#​19">​What is the payconfig file?</​a></​li>​
-<​li><​a href="#​20">​What does the payconfig file contain?</​a></​li>​ +<​li><​a href="#​20">​What is the Integration ID?</​a></​li>​ 
-<​li><​a href="#​21">​What RBA version is supported on Ingenico Devices?</​a></​li>​ +<​li><​a href="#​21">​What does the payconfig file contain?</​a></​li>​ 
-<​li><​a href="#​22">​How do I check my firmware or RBA version?</​a></​li>​+<​li><​a href="#​22">​What RBA version is supported on Ingenico Devices?</​a></​li>​ 
 +<​li><​a href="#​22">​What UPP version is supported on Ingenico Devices?</​a></​li>​ 
 +<​li><​a href="#​23">​How do I check my firmware or RBA version?</​a></​li>​
 </ol> </ol>
 <div class="​faq"​ id="​1">​ <div class="​faq"​ id="​1">​
Line 214: Line 216:
     ​     ​
     <ol>     <ol>
-      <​li><​b>​TEST credentials to the %CompanyName platform - Terminal ID and Secret</b>+      <​li><​b>​TEST credentials to the %CompanyName platform - Terminal ID</​b>​
 <​p>​The %CompanyName integration team will give you login credentials to the Virtual Terminal and SelfCare reporting system. These credentials should also be used to point your integration to our test host simulator.</​p>​ <​p>​The %CompanyName integration team will give you login credentials to the Virtual Terminal and SelfCare reporting system. These credentials should also be used to point your integration to our test host simulator.</​p>​
 <​p>​You can use SelfCare to view transactions and perform actions such as Refunds/​Voids etc.Training on SelfCare/ Virtual Terminal can provided by our support team on request.</​p></​li>​ <​p>​You can use SelfCare to view transactions and perform actions such as Refunds/​Voids etc.Training on SelfCare/ Virtual Terminal can provided by our support team on request.</​p></​li>​
Line 238: Line 240:
 </​div>​ </​div>​
 <div class="​faq"​ id="​20">​ <div class="​faq"​ id="​20">​
 + <​h4>​What is the Integration ID?</​h4>​
 +   
 +    An Integration ID is a key used to identify the business operating the terminal.
 +                    <div class="​infobox warning">​
 +            <div class="​infoboxtext">​
 +The system will reject any transaction that is already associated to a partner and it is not using the correct Integration ID. 
 + </​div></​div>​
 +
 +</​div>​
 +<div class="​faq"​ id="​21">​
  <​h4>​What does the payconfig file contain?</​h4>​  <​h4>​What does the payconfig file contain?</​h4>​
     <p>     <p>
Line 244: Line 256:
 <​pre>&​lt;?​xml version="​1.0"​ encoding="​utf-8"?&​gt;​ <​pre>&​lt;?​xml version="​1.0"​ encoding="​utf-8"?&​gt;​
 &​lt;​resources&​gt;​ &​lt;​resources&​gt;​
-&nbsp; &​lt;​string name="​gatewayLiveUrl"&​gt;​https://​%gatewayLiveUrl&​lt;/​string&​gt;​ +  ​&nbsp; &​lt;​string name="​gatewayLiveUrl"&​gt;​https://​payments.worldnettps.com/​merchant&​lt;/​string&​gt;​ 
-&nbsp; &​lt;​string name="​gatewayTestUrl"&​gt;​https://​%gatewayTestUrl&​lt;/​string&​gt;​ +  &nbsp; &​lt;​string name="​gatewayTestUrl"&​gt;​https://​testpayments.worldnettps.com/​merchant&​lt;/​string&​gt;​ 
-&nbsp; &​lt;​string name="​gatewayDevUrl"&​gt;​https://​%gatewayDevUrl&​lt;/​string&​gt;​ +  &nbsp; &​lt;​string name="​gatewayDevUrl"&​gt;​https://​devpayments.worldnettps.com/​merchant&​lt;/​string&​gt;​ 
-&nbsp; &​lt;​string name="isvToken"&​gt;&​lt;/​string&​gt;​+  &nbsp; &​lt;​string name="​apiKey"&​gt;&​lt;/​string&​gt;​ 
 +  &nbsp; &​lt;​string name="​integrationId"&​gt;&​lt;/​string&​gt;​ 
 +  &nbsp; &​lt;​string name="​logFileAbsoluteDirPath"&​gt;&​lt;/​string&​gt;​ 
 +  &nbsp; &​lt;​string name="​logFileName"&​gt;​log_file.txt&​lt;/​string&​gt;​ 
 +  &nbsp; &​lt;​string name="​logFileMaxLines"&​gt;​10000&​lt;/​string&​gt;​ 
 +  &nbsp; &​lt;​string name="​logFileMaxFileSize"&​gt;​5MB&​lt;/​string&​gt;​ 
 +  &nbsp; &​lt;​string name="logFileMaxFileCount"&​gt;​0&​lt;/​string&​gt;​
 &​lt;/​resources&​gt;​ &​lt;/​resources&​gt;​
 +
 </​pre>​ </​pre>​
  
Line 264: Line 283:
 <​code>​terminal.setMode(CoreMode.DEV);</​code></​li>​ <​code>​terminal.setMode(CoreMode.DEV);</​code></​li>​
  
-<li>isvToken: Generated ​token used for identifying the ISV integration. +<li>apiKey: Generated ​key used for identifying the API integration. 
-<​p>​When you begin your integration we will provide you a generated test token to add to your payconfig file. You can then add this to the isvToken ​string which is located underneath the list of hosts.</​p>​ +<​p>​When you begin your integration we will provide you a generated test key to add to your payconfig file. You can then add this to the apiKey ​string which is located underneath the list of hosts.</​p>​ 
-<​p>​Once the integration is finished you will be provided with a production ​token. This will need to replace the test token in the payconfig file.</​p></​li>​+<​p>​Once the integration is finished you will be provided with a production ​key. This will need to replace the test key in the payconfig file.</​p></​li
 +</​ul>​ 
 + 
 + 
 +<​p>​Log files should be rotated properly based on the settings configured in payconfig.xml file.</p>
 <ul> <ul>
 +<​li>​active log file - the current log file which would be named to logFilename. The lines/size of this file is checked to determine if rotation is needed.</​li>​
 +<​li>​indexed/​numbered log file - rotated files (i.e., if the logFileName is log_file.txt , a possible log file name would be log_file-0.txt</​li>​
 +</ul>
 +
 +<ul>
 +<​h4>​Rotation Policies:</​h4>​
 +<​li>​Line-Based - logs are rotated when the active log file's number of lines goes above the configured maximum lines</​li>​
 +<​li>​Size-Based - logs are rotated when the active log file grows more than the maximum file size</​li>​
 +</ul>
 +<ul>
 +<​h4>​Configuration:</​h4>​
 +<​li><​b>​logFileAbsoluteDirPath</​b>​ - absolute path to the preferred directory for the log files
 +<​p>​default - project directory.</​p></​li>​
 +
 +
 +<​li><​b>​logFileName</​b>​ - preferred log file name
 +<​p>​default - log_file.txt</​p></​li>​
 +
 +<​li><​b>​logFileMaxLines</​b>​ - maximum log file lines to trigger line-based rotation.
 +default - 10000.
 +<​p>​min - 100.</​p></​li>​
 +</ul>
 +
 +<ul>
 +<​li><​b>​logFileMaxFileSizeM</​b>​ - if this is set, we're gonna perform size-based log rotation. Otherwise, we'll do line-based rotation.
 +default - 5MB if set to 0.
 +<​p>​Sample values - 5000 (would be in bytes if no factor), 5KB, 5MB.</​p></​li>​
 +</ul>
 +<ul>
 +<​li><​b>​logFileMaxFileCount</​b>​ - number of indexed/​numbered log files to keep (excluding the active log file).
 +default - 0 (would only rotate the active log file).
 +<​p>​max - 20 (to avoid rotating too many files).</​p></​li>​
 +</ul>
 +
   
 </​div>​ </​div>​
-<div class="​faq"​ id="21">+<div class="​faq"​ id="22">
  <​h4>​What RBA version is supported on Ingenico Devices?</​h4>​  <​h4>​What RBA version is supported on Ingenico Devices?</​h4>​
  
Line 276: Line 333:
           <tr>           <tr>
             <​td>​Device</​td>​             <​td>​Device</​td>​
-            <​td>​RBA 21.0.2</​td>​ 
             <​td>​RBA 23.0.2</​td>​             <​td>​RBA 23.0.2</​td>​
-            <​td>​RBA ​23044</td>+            <​td>​RBA ​2352</td>
           </tr>           </tr>
           <tr>           <tr>
             <​td>​IUC285</​td>​             <​td>​IUC285</​td>​
-            <​td>​-</​td>​ 
             <​td>​Supported</​td>​             <​td>​Supported</​td>​
             <​td>​*Supported</​td>​             <​td>​*Supported</​td>​
Line 288: Line 343:
           <tr>           <tr>
             <​td>​IPP320</​td>​             <​td>​IPP320</​td>​
-            <​td>​Supported</​td>​ 
             <​td>​Supported</​td>​             <​td>​Supported</​td>​
             <​td>​*Supported</​td>​             <​td>​*Supported</​td>​
Line 294: Line 348:
           <tr>           <tr>
             <​td>​IPP350</​td>​             <​td>​IPP350</​td>​
-            <​td>​Supported</​td>​ 
             <​td>​Supported</​td>​             <​td>​Supported</​td>​
             <​td>​*Supported</​td>​             <​td>​*Supported</​td>​
Line 301: Line 354:
         <​p>​*Recommended RBA.</​p>​         <​p>​*Recommended RBA.</​p>​
 </​div>​ </​div>​
- 
 <div class="​faq"​ id="​22">​ <div class="​faq"​ id="​22">​
 + <​h4>​What UPP version is supported on Ingenico Devices?</​h4>​
 +
 +        <​table>​
 +          <tr>
 +            <​td>​Device</​td>​
 +            <​td>​UPP 6.81.08</​td>​
 +          </tr>
 +          <tr>
 +            <​td>​Lane3000</​td>​
 +            <​td>​Supported</​td>​
 +          </tr>
 +
 +        </​table>​
 +        <​p>​*Recommended UPP.</​p>​
 +</​div>​
 +
 +<div class="​faq"​ id="​23">​
  <​h4>​How do I check my firmware or RBA version?</​h4>​  <​h4>​How do I check my firmware or RBA version?</​h4>​
     <p>     <p>