Home

API Reference

Authentication

Ecommerce APIs

POS APIs

Token-Based Transactions

Request Format

Response Format

Resources

Transaction Management

Payment Methods

Test Cards

Entry Modes

Response Codes

Default

Payment Orchestration

apiKey

secret

Production

Demo

<h2 class="slate-h2">TNS Payment Orchestration Developer Portal</h2><p class="slate-p" placeholder="Type / for widgets">&lt;Space for Marketing Messaging&gt;</p><p class="slate-p" placeholder="Type / for widgets"></p><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/getting-started" target="_self">Quick Start</a></h3><p class="slate-p" placeholder="Type / for widgets"></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p slate-indent-0" style="margin-left:0px" placeholder="Type / for widgets"></p><h2 class="slate-h2">Payment Solutions</h2><p class="slate-p" placeholder="Type / for widgets">&lt;Space for Marketing Messaging&gt;</p><table class="slate-table"><colgroup><col style="width:41.492776886035315%"/><col/></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Hosted Solutions</h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/hosted-checkout" target="_self">Hosted Checkout</a></h3><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/hosted-fields" target="_self">Hosted Fields</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Ecommerce API Integrations</h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis" target="_self">Ecommerce REST API</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Point of Sale Integrations</h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/pos-apis" target="_self">POS REST API</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p slate-indent-0" style="margin-left:0px" placeholder="Type / for widgets"></p><h2 class="slate-h2">Extra Features</h2><p class="slate-p" placeholder="Type / for widgets">&lt;Space for Marketing Messaging&gt;</p><table class="slate-table"><colgroup><col style="width:41.73354735152488%"/><col/></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Card Blocking</h3><p class="slate-p" placeholder="Type / for widgets">Blacklist credit cards through our easy to use merchant portal</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/merchant-portal" target="_self">Learn More</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Card Storage</h3><p class="slate-p" placeholder="Type / for widgets">Tokenize card information to charge customers later</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/tokenization" target="_self">Tokenization REST API</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Card Hashing</h3><p class="slate-p" placeholder="Type / for widgets">Hash cards for fast and safe comparison</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-references/tokenization/card-hash" target="_self">Card Hashing REST API</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Apple Pay, Google Pay and PayPal</h3><p class="slate-p" placeholder="Type / for widgets">Support fast, easy and convenient secure payment options</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/alternative-payment-methods" target="_self">Learn More</a></h3><p class="slate-p" placeholder="Type / for widgets"></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Incremental Authorization</h3><p class="slate-p" placeholder="Type / for widgets">Increase authorized totals before final capture</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/secondary-transactions-1/incremental" target="_self">Incremental REST API</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Real-Time Data Reporting</h3><p class="slate-p" placeholder="Type / for widgets">Retrieve detailed up-to-the-minute transaction and audit information </p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/merchant-portal" target="_self">Learn More</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">3D Secure</h3><p class="slate-p" placeholder="Type / for widgets">Add 3DS2 authentication to reduce the risk of fraud</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/fraud-prevention" target="_self">Learn More</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">AVS</h3><p class="slate-p" placeholder="Type / for widgets">Support address validation to reduce fraud</p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/fraud-prevention" target="_self">Learn More</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets"></p><h2 class="slate-h2">International Presence</h2><p class="slate-p" placeholder="Type / for widgets">&lt;Space for Marketing Messaging&gt;</p><table class="slate-table"><colgroup><col style="width:42.375601926163725%"/><col/><col/></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">North America</h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Europe</h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3">Asia-Pacific</h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

TNS Payment Orchestration Developer Portal

We offer fast, secure and reliable APIs to use in your ecommerce implementation or integrate with your point of sale devices to support the lifecycle of your payment transactions.  

All of our REST APIs authenticate using an API key and a secret. These items along with the request body and current timestamp are used to create an HMAC hash. For information on how to create and send this hash along with examples, see 

<p class="slate-p" placeholder="Type / for widgets"><span style="color:rgb(0, 0, 0)" class="slate-color">Every request to TNS Gateway API is to be authenticated by HMAC by creating a signature of the request payload using API Key and Secret provided by TNS. </span></p><h2 class="slate-h2"><span style="color:rgb(0, 0, 0)" class="slate-color">How to generate hmac</span></h2><p class="slate-p" placeholder="Type / for widgets"><span style="color:rgb(0, 0, 0)" class="slate-color"></span></p><ol class="slate-ol"><li class="slate-li"><div style="position:relative"><code class="slate-code">APIKey</code> (Provided by TNS)</div></li><li class="slate-li"><div style="position:relative"><code class="slate-code">Secret</code> (Provided by TNS)</div></li><li class="slate-li"><div style="position:relative"><span style="color:rgb(0, 0, 0)" class="slate-color">Take the </span><span style="color:rgb(0, 0, 0)" class="slate-color"><code style="color:rgb(0, 0, 0)" class="slate-code">timestamp</code></span><span style="color:rgb(0, 0, 0)" class="slate-color"> at the time of signing</span></div></li><li class="slate-li"><div style="position:relative"><span style="color:rgb(0, 0, 0)" class="slate-color">Get data/</span><span style="color:rgb(0, 0, 0)" class="slate-color"><code style="color:rgb(0, 0, 0)" class="slate-code">payload</code></span><span style="color:rgb(0, 0, 0)" class="slate-color"> (which will be sent as request body) as string</span></div></li><li class="slate-li"><div style="position:relative"><span style="color:rgb(0, 0, 0)" class="slate-color">Concatenate </span><span style="color:rgb(0, 0, 0)" class="slate-color"><code style="color:rgb(0, 0, 0)" class="slate-code">APIKey</code></span><span style="color:rgb(0, 0, 0)" class="slate-color"> </span><span style="color:rgb(0, 0, 0)" class="slate-color"><u style="color:rgb(0, 0, 0)" class="slate-underline"><code style="color:rgb(0, 0, 0)" class="slate-code">“:” </code></u></span><span style="color:rgb(0, 0, 0)" class="slate-color"><code style="color:rgb(0, 0, 0)" class="slate-code">timestamp</code></span><span style="color:rgb(0, 0, 0)" class="slate-color"> </span><span style="color:rgb(0, 0, 0)" class="slate-color"><u style="color:rgb(0, 0, 0)" class="slate-underline"><code style="color:rgb(0, 0, 0)" class="slate-code">“:”</code></u></span><span style="color:rgb(0, 0, 0)" class="slate-color"><u style="color:rgb(0, 0, 0)" class="slate-underline"> </u></span><span style="color:rgb(0, 0, 0)" class="slate-color"><code style="color:rgb(0, 0, 0)" class="slate-code">payload</code></span></div></li><li class="slate-li"><div style="position:relative"><span style="color:rgb(0, 0, 0)" class="slate-color">Generate HMAC by using </span><span style="color:rgb(0, 0, 0)" class="slate-color"><code style="color:rgb(0, 0, 0)" class="slate-code">Secret</code></span><span style="color:rgb(0, 0, 0)" class="slate-color"> provided by TNS</span></div></li></ol><p class="slate-p" placeholder="Type / for widgets"><span style="color:rgb(0, 0, 0)" class="slate-color">HMAC can be generated by using SHA256 or SHA512 algorithm. While creating APIKey, we can select the SHA algorithm type.</span></p><p class="slate-p" placeholder="Type / for widgets"><span style="color:rgb(0, 0, 0)" class="slate-color">Here&apos;s a simple example of HMAC calculation using JavaScript</span></p><pre class="slate-CodeBlockElement slate-code_block"><div contenteditable="false"><div ><span aria-live="polite" aria-atomic="false" aria-relevant="additions text" ></span><div ><div ><div >Select...</div><div ><div  style="display:inline-block"><input type="text" autoCapitalize="none" autoComplete="off" autoCorrect="off" id="react-select-10-input" spellcheck="false" tabindex="0" value="" aria-autocomplete="list" style="box-sizing:content-box;width:1px;label:input;background:0;border:0;font-size:inherit;opacity:1;outline:0;padding:0;color:inherit"/><div style="position:absolute;top:0;left:0;visibility:hidden;height:0;overflow:scroll;white-space:pre"></div></div></div></div><div ><span ></span><div  aria-hidden="true"><svg height="20" width="20" viewBox="0 0 20 20" aria-hidden="true" focusable="false" ><path d="M4.516 7.548c0.436-0.446 1.043-0.481 1.576 0l3.908 3.747 3.908-3.747c0.533-0.481 1.141-0.446 1.574 0 0.436 0.445 0.408 1.197 0 1.615-0.406 0.418-4.695 4.502-4.695 4.502-0.217 0.223-0.502 0.335-0.787 0.335s-0.57-0.112-0.789-0.335c0 0-4.287-4.084-4.695-4.502s-0.436-1.17 0-1.615z"></path></svg></div></div></div></div></div><code class="language-javascript keep-markup drop-tokens"><div class="slate-code_line">function generateHMAC(apiKey, secret, requestBody)</div><div class="slate-code_line">{</div><div class="slate-code_line">    var time = new Date().getTime();</div><div class="slate-code_line">    var rawSignature = apiKey + &quot;:&quot; + time + &quot;:&quot; + requestBody;</div><div class="slate-code_line">    var signature = signHMAC(rawSignature, secret);</div><div class="slate-code_line">    return signature;</div><div class="slate-code_line">}</div><div class="slate-code_line"></div><div class="slate-code_line">function signHMAC(rawSignature, secret) {</div><div class="slate-code_line">    const signature = CryptoJS.HmacSHA512(rawSignature, secret);</div><div class="slate-code_line">    const hexSignature = CryptoJS.enc.Hex.stringify(signature);</div><div class="slate-code_line">    return hexSignature;</div><div class="slate-code_line">}</div><div class="slate-code_line"></div></code></pre><p class="slate-p" placeholder="Type / for widgets"></p>

Every request to TNS Gateway API is to be authenticated by HMAC by creating a signature of the request payload using API Key and Secret provided by TNS. 

HMAC can be generated by using SHA256 or SHA512 algorithm. While creating APIKey, we can select the SHA algorithm type.

Here's a simple example of HMAC calculation using JavaScript

<p class="slate-p" placeholder="Type / for widgets">Our ecommerce APIs empower online businesses to seamlessly integrate payment processing capabilities into their websites and mobile applications. These APIs act as a critical conduit between ecommerce platforms, payment processors, and banks, facilitating secure and efficient transactions. Additionally, they ensure adherence to PCI DSS compliance standards.</p><p class="slate-p" placeholder="Type / for widgets"></p><table class="slate-table"><colgroup></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-authorization" target="_self">Authorization</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-sale" target="_self">Sale</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-refund" target="_self">Refund</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-secondary-transactions" target="_self">Secondary Transactions</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/pos-apis/pos-authorizations/pos-authorization-using-emv-chip" target="_blank">https://app.theneo.io/tnsi/payment-orchestration/api-reference/pos-apis/pos-authorizations/pos-authorization-using-emv-chip</a></p>

Our ecommerce APIs empower online businesses to seamlessly integrate payment processing capabilities into their websites and mobile applications. These APIs act as a critical conduit between ecommerce platforms, payment processors, and banks, facilitating secure and efficient transactions. Additionally, they ensure adherence to PCI DSS compliance standards.

<p class="slate-p" placeholder="Type / for widgets">An authorization transaction is to authorize the card with the cardholder&apos;s issuing bank and verify that the card is valid and there are enough funds in the cardholder&apos;s account to pay for the purchase. This step doesn&apos;t transfer the funds. To get the funds from the cardholder&apos;s account to the merchant&apos;s account, the approved transaction should be captured. The Authorization transactions are usually used by merchants when the goods are delivered later after the purchase.</p><p class="slate-p" placeholder="Type / for widgets">The sample transaction here lists the required mandatory fields to get the transaction approved. </p><p class="slate-p" placeholder="Type / for widgets">For more info on additional functionality and optional fields, see our full request functionality at <a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/request-format" target="_self">Request Format</a>.</p><p class="slate-p" placeholder="Type / for widgets">For more information on all possible responses, success and error codes, please refer to the <a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/response-format" target="_self">Response Format</a>.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

An authorization transaction is to authorize the card with the cardholder's issuing bank and verify that the card is valid and there are enough funds in the cardholder's account to pay for the purchase. This step doesn't transfer the funds. To get the funds from the cardholder's account to the merchant's account, the approved transaction should be captured. The Authorization transactions are usually used by merchants when the goods are delivered later after the purchase.

The sample transaction here lists the required mandatory fields to get the transaction approved. 

For more info on additional functionality and optional fields, see our full request functionality at 

For more information on all possible responses, success and error codes, please refer to the 

Ecommerce Authorization

The identifier for the transaction in your system formatted as a string

clientTransactionId

This is the effective date of the transaction in UTC formatted as YYYYMMDDHHmmss.

transactionDate

This allows you to specify whether this a credit or debit transaction. This is formatted as string and always in uppercase.

tenderType

This is used to specify from which channel the this transaction originated. We'll do a credit card request for now.

paymentChannel

orderInformation

paymentInformation

merchant

Content-Type

<p class="slate-p" placeholder="Type / for widgets">A sale transaction can be explained as authorization and capture of funds at the same time. The sale transactions are usually used by merchants who deliver the goods almost immediately like retail stores where the customer receives the goods immediately.</p><p class="slate-p" placeholder="Type / for widgets">In ecommerce scenario, the user or the cardholder directly enters the card data during the checkout process. In the paymentInformation section of the request, the card details are provided in the respective fields. The sample transaction here lists the required mandatory fields to get the transaction approved. </p><p class="slate-p" placeholder="Type / for widgets">For more info on additional functionality and optional fields, see our full request functionality at <a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/request-format" target="_self">Request Format</a>.</p><p class="slate-p" placeholder="Type / for widgets">For more information on all possible responses, success and error codes, please refer to the <a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/response-format" target="_self">Response Format</a>.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

A sale transaction can be explained as authorization and capture of funds at the same time. The sale transactions are usually used by merchants who deliver the goods almost immediately like retail stores where the customer receives the goods immediately.

In ecommerce scenario, the user or the cardholder directly enters the card data during the checkout process. In the paymentInformation section of the request, the card details are provided in the respective fields. The sample transaction here lists the required mandatory fields to get the transaction approved. 

Ecommerce Sale

<p class="slate-p" placeholder="Type / for widgets">A refund transaction is where the merchant has to return the money to the customer. <span style="color:rgb(0, 0, 0)" class="slate-color">It allows merchants to reimburse customers for returned merchandise, canceled services or other situations where a refund is warranted.</span></p><p class="slate-p" placeholder="Type / for widgets"><span style="color:rgb(0, 0, 0)" class="slate-color">An unlinked refund, also known as a standalone refund or independent refund or credit transaction, is a type of refund transaction where the refund amount is not directly associated with a specific previous transaction. Instead, it is processed as a separate, standalone refund transaction without any direct reference to a previous purchase.</span></p><p class="slate-p" placeholder="Type / for widgets"><span style="color:rgb(0, 0, 0)" class="slate-color">Unlinked refunds are commonly used in situations where the refund amount is not tied to a specific previous transaction or where the merchant prefers to process refunds independently of the original transaction. For example, if a customer requests a refund for a subscription fee or membership dues, the merchant may issue an unlinked refund without referencing a specific purchase transaction.</span></p><p class="slate-p" placeholder="Type / for widgets">For more info on additional functionality and optional fields, see our full request functionality at <a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/request-format" target="_self">Request Format</a>.</p><p class="slate-p" placeholder="Type / for widgets">For more information on all possible responses, success and error codes, please refer to the <a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/response-format" target="_self">Response Format</a>.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

A refund transaction is where the merchant has to return the money to the customer. 

It allows merchants to reimburse customers for returned merchandise, canceled services or other situations where a refund is warranted.

An unlinked refund, also known as a standalone refund or independent refund or credit transaction, is a type of refund transaction where the refund amount is not directly associated with a specific previous transaction. Instead, it is processed as a separate, standalone refund transaction without any direct reference to a previous purchase.

Unlinked refunds are commonly used in situations where the refund amount is not tied to a specific previous transaction or where the merchant prefers to process refunds independently of the original transaction. For example, if a customer requests a refund for a subscription fee or membership dues, the merchant may issue an unlinked refund without referencing a specific purchase transaction.

Ecommerce Refund

<p class="slate-p" placeholder="Type / for widgets">Once the merchant delivers the goods or services purchased, to realize the funds into the merchant&apos;s bank, the approved authorizations have to be captured using a capture transaction. Or when the customer cancels the order or returns the goods, the merchant can cancel the approved primary transaction in its entirety or refund only partial funds using void or reversal or refund.</p><p class="slate-p" placeholder="Type / for widgets">All such transactions are made on a primary transaction, they are termed as secondary transactions or we can call them as follow-up transactions. For secondary transactions, the card need not be presented at the point of sale(POS) or to the merchant. We are running additional transactions based on an approved primary transaction. PayOrch platform provides simple APIs to perform secondary transactions. </p><p class="slate-p" placeholder="Type / for widgets">PayOrch platform returns a transaction identifier in the response of the primary transaction. That transaction identifier is the important data used to run secondary or follow-up transactions. In a case where the transaction identifier of the primary transaction is lost, other parameters can be used to run the secondary transactions.</p><p class="slate-p" placeholder="Type / for widgets"></p><table class="slate-table"><colgroup></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-secondary-transactions/ecommerce-capture" target="_self">Capture</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-secondary-transactions/ecommerce-linked-refund" target="_self">Linked Refund</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-secondary-transactions/ecommerce-reversal" target="_self">Reversal</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-secondary-transactions/ecommerce-void" target="_self">Void</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-secondary-transactions/ecommerce-incremental" target="_self">Incremental</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-secondary-transactions/ecommerce-adjustment" target="_self">Adjustment</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

Once the merchant delivers the goods or services purchased, to realize the funds into the merchant's bank, the approved authorizations have to be captured using a capture transaction. Or when the customer cancels the order or returns the goods, the merchant can cancel the approved primary transaction in its entirety or refund only partial funds using void or reversal or refund.

All such transactions are made on a primary transaction, they are termed as secondary transactions or we can call them as follow-up transactions. For secondary transactions, the card need not be presented at the point of sale(POS) or to the merchant. We are running additional transactions based on an approved primary transaction. PayOrch platform provides simple APIs to perform secondary transactions. 

PayOrch platform returns a transaction identifier in the response of the primary transaction. That transaction identifier is the important data used to run secondary or follow-up transactions. In a case where the transaction identifier of the primary transaction is lost, other parameters can be used to run the secondary transactions.

Ecommerce Secondary Transactions

<p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets">For more info on additional functionality and optional fields, see our full request functionality at <a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/request-format" target="_self">Request Format</a>.</p><p class="slate-p" placeholder="Type / for widgets">For more information on all possible responses, success and error codes, please refer to the <a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/response-format" target="_self">Response Format</a>.</p><p class="slate-p" placeholder="Type / for widgets"></p><p class="slate-p" placeholder="Type / for widgets"></p>

Ecommerce Capture

originalTransaction

Ecommerce Linked Refund

Ecommerce Reversal

Ecommerce Void

Ecommerce Incremental

Ecommerce Adjustment

New Section

<p class="slate-p" placeholder="Type / for widgets">In the card present scenario, the user or the cardholder presents the physical card at the point of sale(POS) machines. In the payment information section of the request, the card details are provided in the form of EMV data or Track data.</p><p class="slate-p" placeholder="Type / for widgets">Based on how the card is presented at the point of sale, We have 3 types of card present scenarios. For more information on the <a href="https://app.theneo.io/tnsi/payment-orchestration/resources/entry-modes" target="_self">entry modes</a>, please refer to the Resources section </p><ol class="slate-ol"><li class="slate-li"><div style="position:relative">The cardholder inserts the card containing the EMV chip into the card reader of the point of sale(POS) machine.</div></li><li class="slate-li"><div style="position:relative">The cardholder taps or waves the card containing the EMV chip onto the card reader of the point of sale(POS) machine</div></li><li class="slate-li"><div style="position:relative">If the payment card does not contain any chip, the cardholder could use the magnetic stripe of the card and swipe it on the magnetic stripe reader of the point of sale(POS) machine</div></li></ol><p class="slate-p" placeholder="Type / for widgets"></p><table class="slate-table"><colgroup></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/pos-apis/pos-authorizations" target="_self">Authorizations</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/pos-apis/pos-sale" target="_self">Sale</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/pos-apis/pos-refund" target="_self">Refund</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/pos-apis/pos-secondary-transactions" target="_self">Secondary Transactions</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets"></p>

In the card present scenario, the user or the cardholder presents the physical card at the point of sale(POS) machines. In the payment information section of the request, the card details are provided in the form of EMV data or Track data.

Based on how the card is presented at the point of sale, We have 3 types of card present scenarios. For more information on the 

<p class="slate-p" placeholder="Type / for widgets">A token represents the card information but does not contain the actual card numbers, thereby reducing the risk of fraud. When a transaction is initiated, the token is sent in the request payload instead of the actual account number, protecting the customer&apos;s financial data. We use this token to authorize and complete transactions without exposing card details.</p><p class="slate-p" placeholder="Type / for widgets">Tokens are used to swap out card details in primary transactions. Secondary transactions don’t use tokens; instead, they rely on a TNS Reference or Client Transaction Reference. For more details on secondary transactions, please refer to the section on<a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/ecommerce-apis/ecommerce-secondary-transactions" target="_self"> Secondary Transactions.</a></p><p class="slate-p" placeholder="Type / for widgets"></p><table class="slate-table"><colgroup></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/token-based-transactions/token-based-authorization" target="_self">Authorization</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/token-based-transactions/token-based-sale" target="_self">Sale</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><p class="slate-p" placeholder="Type / for widgets"><a href="https://app.theneo.io/tnsi/payment-orchestration/api-reference/token-based-transactions/token-based-refund" target="_self">Refund</a></p></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets"></p>

A token represents the card information but does not contain the actual card numbers, thereby reducing the risk of fraud. When a transaction is initiated, the token is sent in the request payload instead of the actual account number, protecting the customer's financial data. We use this token to authorize and complete transactions without exposing card details.

Tokens are used to swap out card details in primary transactions. Secondary transactions don’t use tokens; instead, they rely on a TNS Reference or Client Transaction Reference. For more details on secondary transactions, please refer to the section on

stan

Client Unique Transaction Identifier. This is the unique identifier that you use to identify transaction in your system

Flag that indicates whether the transaction is enabled for partial authorization. Default value is always set to true

partialAuthIndicator

Original transaction group is required for follow-up transaction. Any of the available identification field is used to refer the original transaction stored in the TNS database

Merchant related information should be provided under this section

Transaction authorized date time in UTC format. This is when the transaction was approved by the acquirer

authorizedDate

An unique identifier for the transaction generated by TNS. Use this transactionId for all follow-up transactions

transactionId

6 digit System Trace Audit Number which was passed in the request

Client Unique Transaction Identifier which was passed during the request by the client

Transaction Tender type. Same value is returned which was passed during the request

TNS generated response code for the transaction. For list of all response code please refer the Response Code section

tnsResponseCode

TNS generated response text. For all the response text please refer the Response Code section in the document

tnsResponseText

hostResponseCode

hostResponseText

Transaction settlement date generated by TNS

settlementDate

x_request_id

amount

card

Transaction Authorization Code provided by the acquirer

authCode

ORN (Original Reference Number) is a unique identifier associated with each transaction. It consists of several parts, including TID, Message Sequence Number, Buffer Number, Scheme Identifier, and Acquirer Identifier. The format of ORN varies depending on the transaction type and may contain additional information such as Authorization Number, Transaction Action, and Retrieval Reference Number

token

<p class="slate-p" placeholder="Type / for widgets">This section provides valuable resources to assist with the integration of our APIs.</p><p class="slate-p" placeholder="Type / for widgets"></p><table class="slate-table"><colgroup></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/resources/test-cards" target="_self">Test Cards</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/resources/entry-modes" target="_self">Entry Modes</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr><tr class="slate-tr"><td class="slate-td"><div class="slate-TableCellElement-content"><h3 class="slate-h3"><a href="https://app.theneo.io/tnsi/payment-orchestration/resources/response-codes-2" target="_self">Response Codes</a></h3></div><div class="slate-TableCellElement-resizableWrapper" contenteditable="false"><div style="position:relative;user-select:auto;width:100%;height:100%;box-sizing:border-box;flex-shrink:0" ><div><div  style="position:absolute;user-select:none;width:10px;height:calc(100% + 12px);top:-12px;cursor:col-resize;right:-5px;z-index:20"></div></div></div><div class="slate-TableCellElement-handle"></div></div><div class="slate-TableCellElement-selectedCell" contenteditable="false"></div></td></tr></tbody></table><p class="slate-p" placeholder="Type / for widgets"></p>

This section provides valuable resources to assist with the integration of our APIs.

Sections