View Previous: triPOS Cloud OverviewView Next: Integration Guide
Overview
Using the resources on this page you will learn how to quickly process a payment transaction without the requirement of a physical PIN pad. The triPOS product family (PC, Mobile and Cloud) leverage a Null simulator in our certification environment. Developers have the ability to mimic production processing scenarios, without the need for physical PIN pads, or test cards. In this tutorial, you will be able to process a sample sale request within minutes using third party APIs tools such as Advanced REST Client. Developers integrating to triPOS Cloud will need to request a set of test cards, create an Express account and complete a discovery call with a solutions consultant. To access our transaction API click here.
To ensure your product will provide the best processing experience for your customers, Vantiv's Developer Integration team will aid you in completing a software certification. Please review the integration guide for complete details about integrating, testing and certifying.
Don't have an Express account?
If you do not already have Express test credentials, go to click here and create a test account. You will receive an email containing the required credentials needed to access triPOS Cloud:
- AccountID
- AccountToken
- ApplicationID
- AcceptorID
IMPORTANT NOTE: If you plan testing EMV you will need to request additional credentials from certification@vantiv.com
Tools/APIs used
Tools such as Advanced REST Client, Postman, or cURL are excellent tools to become familiar triPOS Cloud. This tutorial demonstrates calling the triPOS Cloud API while leveraging Advanced REST Client.
Additional resources to aid you through are development efforts can be found here:
Sample Sale Request
Step 1: Add Request Headers
triPOS Cloud supports a production URL and a certification URL. For this scenario, we will demonstrate how to process a sale request using the certification URL https://triposcert.vantiv.com/api/v1/sale
PRODUCTION URL: https://tripos.vantiv.com
Using your preferred test tool, add the headers to the request. For complete list of transactions and headers refer to the triPOS Cloud API
tp-application-id: 1234 tp-application-name: triPOS.Dan.Cloud tp-application-version: 1.0.0 tp-authorization: Version=2.0 accept: application/json Content-Type: application/json tp-express-acceptor-id:{your express acceptor id} tp-express-account-id:{your express account id} tp-express-account-token:{your express token} tp-request-id:{valid GUID}
Step 2: Build the transaction payload
The use of laneID 9999 triggers the simulator. In a production environment, laneID is used to identify the PIN pad triPOS Cloud service will initiate. For a complete list of parameters supported within a transaction payload view the triPOS Cloud API
{ "laneId":"9999", "transactionAmount":"1.22" }
Sample Sale Response
Response Headers
Response Body
View Next: Integration Guide View Previous: triPOS Cloud Overview
Thanks Chris - this is helpful. Adding dourada. I was just running through this example and ran into trouble with the tp-request-id. I understand this parameter is mandatory with triPOS cloud. I just wanted to share this in case others run into the same issue.
With my first attempts following the example above I kept receiving HTTP response 500 with this JSON response:
{
"exceptionType": "System.ArgumentException",
"exceptionMessage": "Provided request id is not a GUID."
}
I wasn't sure what value to enter for the UUID.
I came across this helpful site - Online UUID Generator Tool
As soon as I entered a valid UUID in the headers (below) the request worked. I used a "version 1" UUID and it seemed to be fine.
tp-application-id: 1234
tp-application-name: triPOS.YDP.Cloud
tp-application-version: 1.0.0
tp-authorization: Version=2.0
accept: application/json
Content-Type: application/json
tp-express-acceptor-id:3928907
tp-express-account-id:1045836
tp-express-account-token:5CFF00007319E5C0C7DB2F7C144E65068A462ED2549C6360099A962C573ED9EF1BB97401
tp-request-id:24dddd32-6c89-11e7-907b-a6006ad3dba0
I used the same payload as your example.
{
"laneId":"9999",
"transactionAmount":"1.22"
}