- Introduction
- Step 1: Authentication
- Step 2: Sample Request
- Step 3: Test Card
- Resources
- Authorization
- Sale
- Refund
- Authorization
- Sale
- Refund
- Capture
- Reversal
- Void
- Linked Refund
- Incremental
- Request Format
- Response Format
- Transaction Management
- Response Codes
In this page
Primary Transactions
Token Based Transactions
Secondary Transactions
Useful Resources
You've chosen our Online REST API
Custom build your payment forms and directly call our flexible REST APIs for complete control of your payment processing experience.
Introduction
The TNS PayOrch platform provides a range of APIs specifically created for handling online card-not-present transactions across multiple channels such as websites, mobile applications, shopping cart checkout pages, and telephone transactions. Through TNS's APIs, users can effectively oversee the complete lifecycle of online transactions and produce detailed reports for customers via our PayOrch Merchant Portal.
For a list of supported transaction types, see our Online REST API documentation. For detailed information regarding the request and response fields, see Request Format and Response Format sections of our documentation.
Additionally, you have the opportunity to explore each transaction type using our API Explorer.
Let's begin with an example. In this demonstration, we will guide you through a few steps to execute a simple sale request.
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 ecommerce REST APIs, you will initiate calls from your backend system directly to our payment processing system. To commence, you must 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. Let us proceed by initiating a straightforward sale request.
For information on header parameters and request body fields, see Sale Request section of our documentation.
Sample Response
For a comprehensive guide and detailed information on response fields, see Response Format section of our documentation.
In the following table, we offer a concise overview of the selected 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.
| Field | Description | Type | Example |
|---|
Step 3
Test payment
Use the following test card information to make a payment transaction.
Test Card
4111 1111 1111 1111
| Card Holder | Valid Thru |
Any valid cardholder name |
Any future date in MM/YY format |
CVV - Any three digit number
Address information - Any valid address
For more test cards to use, see Test Cards.
Explore our documentation to understand the useful techniques to successfully manage the transaction lifecycle
Transactions |
|---|
| Primary Transactions |
|---|
Authorization |
Sale |
Refund |
| Token Based Transactions |
|---|
Authorization |
Sale |
Refund |
| Secondary Transactions |
|---|
Capture |
Reversal |
Void |
Linked Refund |
Incremental |
Useful Resources |
|---|
Request Format |
Response Format |
Transaction Management |
Response Codes |
That's It, You're Done!
You have successfully made a payment. For more detailed information on fields and requirements, see Request Format and Response Format sections of our documentation.