You've chosen our Terminal REST API

Step 1

Get start with Authentication

All requests made through our system are authenticated using HMAC. To execute a sample request, you will need to obtain the API Key and Secret from TNS. Please reach out to our support team to acquire the API Key and Secret.

If you want to see how to create a HMAC signature, see Authentication section of our documentation.

Step 2

Try a sample sale request

When utilizing our Terminal REST APIs, you will initiate calls from your backend system directly to our payment processing system. To commence, it is essential to acquaint yourself with our APIs and calling options through your preferred programming language. We will utilize our API Explorer to execute a basic call together, enabling you to observe the functionality of our APIs. To proceed, we will execute a simple request for a simple sale, presuming that the cardholder has inserted their EMV Chip card into the card reader of the point-of-sale(POS) machine. ( Learn more about Entry Modes )

                                                    

                                                    
    
                                                    
                                                    

                                                        View in Documentation
                                                        Run in API Explorer
                                                    
                                                

We may have successfully completed a sale transaction using the example data provided. To verify this in real-time, you will need a point-of-sale(POS) machine capable of reading payment cards, either through EMV chip or magnetic stripe technology. Please explore our Terminal Solutions to enable your business to start accepting payments via payment cards.

Sample Response

                                                    

                                                        JSON
                                                    
                                                    

                                                    
                                                    

                                                

For a complete reference and detailed information on response fields, see Response Format section of our documentation.

In the following table, we offer a concise overview of select fields that are crucial for understanding the response from our system. This information will assist you in quickly grasping the relevant details needed to comprehend the outcome of the transaction and guide you on the subsequent actions required.

Step 3

Learn more about terminal integration

Explore our documentation to understand the useful techniques to successfully manage the transaction lifecycle

That's It, You're Done!

You just made a payment. For more detailed information on fields and requirements, see Request Format and Response Format sections of our documentation.