/api/v1

GET
/api/v1 Returns an array of links for accessing version 1.0 of the triPOS API

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetServicesResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
GetServicesResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
GetServicesResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
POST
/api/v1/authorization Creates a new card authorization based on the passed in parameters

Implementation Notes

This creates a transaction used to hold funds when the total amount of the purchase is unknown. The Incremental Authorization HATEAOS link is only supported for AutoRental and HotelLodging.

Parameters

Parameter Parameter Type Data Type Description
action query string The action to perform with the authorization. This can either be 'store' or 'forward'. More information on Store and Forward here.
requestIdToForward query string The request ID of the stored transaction to forward.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
AuthorizationRequest body POST_AuthorizationRequest/v1/authorization undefined

Request Class

AuthorizationRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "commercialCardCustomerCode": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string",
    "promptForSignature": "string"
  },
  "convenienceFeeAmount": "double",
  "healthcare": {
    "clinic": "double",
    "dental": "double",
    "prescription": "double",
    "total": "double",
    "vision": "double"
  },
  "lodging": {
    "duration": "int",
    "prestigiousPropertyCode": "string"
  },
  "referenceNumber": "string",
  "salesTaxAmount": "double",
  "shiftId": "string",
  "ticketNumber": "string",
  "tipAmount": "double"
}
AuthorizationRequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string",
  "promptForSignature": "string"
}
AuthorizationRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
address false POST_Address/v1/authorization The cardholder address information for the transaction.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
commercialCardCustomerCode false string The commercial card customer code for the transaction. This is for Level II.
configuration false POST_AuthorizationRequestConfiguration/v1/authorization Any value included in this section will override the corresponding value set in the triPOS.config
convenienceFeeAmount false double The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged
healthcare false POST_Healthcare/v1/authorization The healthcare section that contains all applicable healthcare-qualified amounts. more»
lodging false POST_LodgingAuthorization/v1/authorization The lodging parameters to be passed in for a lodging transaction. more»
referenceNumber false string A user defined reference number.
salesTaxAmount false double The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
tipAmount false double The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
AuthorizationRequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
promptForSignature false string Specifies how the signature prompt should be handled for the request. If a value is not provided, Never will be used. See Signature Prompt.
Values:
  • Always
  • Never
  • None
Healthcare
Field Required Data Type Description
clinic false double The total amount of healthcare-qualified goods that fall into the category of 'clinic'.
dental false double The total amount of healthcare-qualified goods that fall into the category of 'dental'.
prescription false double The total amount of healthcare-qualified goods that fall into the category of 'prescription'.
total false double The total amount of healthcare-qualified goods. If any healthcare values are included, this value is required to be present.
vision false double The total amount of healthcare-qualified goods that fall into the category of 'vision'.
LodgingAuthorization
Field Required Data Type Description
duration false int The number of hotel stay days. Set to 1 for no show.
prestigiousPropertyCode false string The lodging prestigious property code. For an empty or invalid value, this parameter defaults to NonParticipant.
Values:
  • NonParticipant
  • FiveHundredDollarLimit
  • OneThousandDollarLimit
  • OneThousandFiveHundredDollarLimit
AuthorizationRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/authorization",
    "required": false
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "commercialCardCustomerCode": {
    "description": "The commercial card customer code for the transaction. This is for Level II.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_AuthorizationRequestConfiguration/v1/authorization",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged",
    "type": "double",
    "required": false
  },
  "healthcare": {
    "description": "The healthcare section that contains all applicable healthcare-qualified amounts. <a href='../help/kb/healthcare.html'>more&raquo;</a>",
    "type": "POST_Healthcare/v1/authorization",
    "required": false
  },
  "lodging": {
    "description": "The lodging parameters to be passed in for a lodging transaction. <a href='../help/kb/lodging.html'>more&raquo;</a>",
    "type": "POST_LodgingAuthorization/v1/authorization",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "salesTaxAmount": {
    "description": "The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.",
    "type": "double",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.",
    "type": "double",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}
AuthorizationRequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  },
  "promptForSignature": {
    "description": "Specifies how the signature prompt should be handled for the request. If a value is not provided, Never will be used. See <a href='../help/kb/signaturePrompt.html'>Signature Prompt</a>.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "None"
      ]
    },
    "required": false
  }
}
Healthcare 
{
  "clinic": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'clinic'.",
    "type": "double",
    "required": false
  },
  "dental": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'dental'.",
    "type": "double",
    "required": false
  },
  "prescription": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'prescription'.",
    "type": "double",
    "required": false
  },
  "total": {
    "description": "The total amount of healthcare-qualified goods. If any healthcare values are included, this value is required to be present.",
    "type": "double",
    "required": false
  },
  "vision": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'vision'.",
    "type": "double",
    "required": false
  }
}
LodgingAuthorization 
{
  "duration": {
    "description": "The number of hotel stay days. Set to 1 for no show.",
    "type": "int",
    "required": false
  },
  "prestigiousPropertyCode": {
    "description": "The lodging prestigious property code. For an empty or invalid value, this parameter defaults to NonParticipant.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NonParticipant",
        "FiveHundredDollarLimit",
        "OneThousandDollarLimit",
        "OneThousandFiveHundredDollarLimit"
      ]
    },
    "required": false
  }
}

Response Class

AuthorizationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "approvedAmount": "double",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "convenienceFeeAmount": "double",
  "currencyCode": "string",
  "emv": {
    "applicationIdentifier": "string",
    "applicationLabel": "string",
    "applicationPreferredName": "string",
    "cryptogram": "string",
    "issuerCodeTableIndex": "string",
    "tags": {
      "key": "string",
      "value": "string"
    }
  },
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "fsaCard": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentType": "string",
  "pinVerified": "boolean",
  "signature": {
    "data": "Array<byte>",
    "format": "string",
    "statusCode": "string"
  },
  "statusCode": "string",
  "subTotalAmount": "double",
  "terminalId": "string",
  "tipAmount": "double",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
AuthorizationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
approvedAmount false double The amount approved by the processor. This is the actual amount that will be charged or credited.
binValue false string The BIN entry that matched the account number.
cardHolderName false string The cardholder name.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
convenienceFeeAmount false double The convenience fee added to the transaction
currencyCode false string The currency code used in the transaction.
Values:
  • None
  • Usd
emv false Emv The fields used on the receipt for an EMV transaction. Null if the transaction was not EMV.
entryMode false string Description of how card was entered.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
fsaCard false string Indicates whether the card used was a FSA card.
Note: Maybe = No BIN entry to determine if FSA.
Values:
  • NotApplicable
  • No
  • Yes
  • Maybe
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentType false string Description of payment type utilized.
Values:
  • None
  • Credit
  • Debit
  • Gift
pinVerified false boolean True if the PIN was verified, false if not verified or undetermined.
signature false Signature The signature data.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
subTotalAmount false double The original amount sent for the transaction.
terminalId false string The ID of the terminal used during the transaction
tipAmount false double The tip amount added to the transaction.
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Emv
Field Required Data Type Description
applicationIdentifier false string The Application Identifier also known as the AID. Identifies the application as described in ISO/IEC 7816-5. Printed receipts are required to contain the AID as hexadecimal characters.
applicationLabel false string Mnemonic associated with the AID according to ISO/IEC 7816-5. If the Application Preferred Name is not available or the Issuer code table index is not supported, then the Application Label should be used on the receipt instead of the Application Preferred Name.
applicationPreferredName false string Preferred mnemonic associated with the AID. When the Application Preferred Name is present and the Issuer code table index is supported, then this data element is mandatory on the receipt.
cryptogram false string The EMV cryptogram type and value. It is a preferred best practice to include this data element on the receipt, but is not mandatory. This field contains cryptogram type followed by the cryptogram value.
issuerCodeTableIndex false string Indicates the code table according to ISO/IEC 8859 for displaying the Application Preferred Name.
tags false Array<Tag> A name value collection of additional EMV tags that are required to appear on the receipt.
Tag
Field Required Data Type Description
key false string undefined
value false string undefined
Signature
Field Required Data Type Description
data false Array<byte> The byte array of the signature in the format specified by Format.
format false string The format of the signature.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
statusCode false string Indicates why a signature is or is not present.
Values:
  • Unknown
  • SignatureRequired
  • SignaturePresent
  • SignatureRequiredCancelledByCardholder
  • SignatureRequiredNotSupportedByPinPad
  • SignatureRequiredPinPadError
  • SignatureNotRequiredByThresholdAmount
  • SignatureNotRequiredByPaymentType
  • SignatureNotRequiredByTransactionType
  • SignatureRequiredButPromptSuppressedByMerchant
AuthorizationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "approvedAmount": {
    "description": "The amount approved by the processor. This is the actual amount that will be charged or credited.",
    "type": "double",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The cardholder name.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee added to the transaction",
    "type": "double",
    "required": false
  },
  "currencyCode": {
    "description": "The currency code used in the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": false
  },
  "emv": {
    "description": "The fields used on the receipt for an EMV transaction. Null if the transaction was not EMV.",
    "type": "Emv",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "fsaCard": {
    "description": "Indicates whether the card used was a FSA card.<br />Note: Maybe = No BIN entry to determine if FSA.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NotApplicable",
        "No",
        "Yes",
        "Maybe"
      ]
    },
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentType": {
    "description": "Description of payment type utilized.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Credit",
        "Debit",
        "Gift"
      ]
    },
    "required": false
  },
  "pinVerified": {
    "description": "True if the PIN was verified, false if not verified or undetermined.",
    "type": "boolean",
    "required": false
  },
  "signature": {
    "description": "The signature data.",
    "type": "Signature",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "subTotalAmount": {
    "description": "The original amount sent for the transaction.",
    "type": "double",
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount added to the transaction.",
    "type": "double",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Emv 
{
  "applicationIdentifier": {
    "description": "The Application Identifier also known as the AID. Identifies the application as described in ISO/IEC 7816-5. Printed receipts are required to contain the AID as hexadecimal characters.",
    "type": "string",
    "required": false
  },
  "applicationLabel": {
    "description": "Mnemonic associated with the AID according to ISO/IEC 7816-5. If the Application Preferred Name is not available or the Issuer code table index is not supported, then the Application Label should be used on the receipt instead of the Application Preferred Name.",
    "type": "string",
    "required": false
  },
  "applicationPreferredName": {
    "description": "Preferred mnemonic associated with the AID. When the Application Preferred Name is present and the Issuer code table index is supported, then this data element is mandatory on the receipt.",
    "type": "string",
    "required": false
  },
  "cryptogram": {
    "description": "The EMV cryptogram type and value. It is a preferred best practice to include this data element on the receipt, but is not mandatory. This field contains cryptogram type followed by the cryptogram value.",
    "type": "string",
    "required": false
  },
  "issuerCodeTableIndex": {
    "description": "Indicates the code table according to ISO/IEC 8859 for displaying the Application Preferred Name.",
    "type": "string",
    "required": false
  },
  "tags": {
    "description": "A name value collection of additional EMV tags that are required to appear on the receipt.",
    "type": "Array",
    "items": {
      "$ref": "Tag"
    },
    "required": false
  }
}
Tag 
{
  "key": {
    "type": "string",
    "required": false
  },
  "value": {
    "type": "string",
    "required": false
  }
}
Signature 
{
  "data": {
    "description": "The byte array of the signature in the format specified by Format.",
    "type": "Array",
    "items": {
      "type": "byte"
    },
    "required": false
  },
  "format": {
    "description": "The format of the signature.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "statusCode": {
    "description": "Indicates why a signature is or is not present.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "SignatureRequired",
        "SignaturePresent",
        "SignatureRequiredCancelledByCardholder",
        "SignatureRequiredNotSupportedByPinPad",
        "SignatureRequiredPinPadError",
        "SignatureNotRequiredByThresholdAmount",
        "SignatureNotRequiredByPaymentType",
        "SignatureNotRequiredByTransactionType",
        "SignatureRequiredButPromptSuppressedByMerchant"
      ]
    },
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if client sends in all 5 of the healthcare values as positive values.
400 Returned if any healthcare field has a negative value.
400 Returned if healthcare Total field is less than sum of the other healthcare fields.
400 Returned if MarketCode is not HotelLodging but the request includes lodging parameters on a valid lodging request.
400 Returned if the lodging duration is less than 0 on a valid lodging request.
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
POST
/api/v1/authorization/{paymentAccountId} Creates a new payment account authorization based on the passed in amounts

Parameters

Parameter Parameter Type Data Type Description
paymentAccountId path string The payment account ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
PaymentAccountAuthorizationRequest body POST_PaymentAccountAuthorizationRequest/v1/authorization/{paymentAccountId} undefined

Request Class

PaymentAccountAuthorizationRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "clerkNumber": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string"
  },
  "convenienceFeeAmount": "double",
  "healthcare": {
    "clinic": "double",
    "dental": "double",
    "prescription": "double",
    "total": "double",
    "vision": "double"
  },
  "referenceNumber": "string",
  "shiftId": "string",
  "ticketNumber": "string",
  "tipAmount": "double"
}
RequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string"
}
PaymentAccountAuthorizationRequest
Field Required Data Type Description
laneId true int Specifies which lane to use for the card sale.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
address false POST_Address/v1/authorization/{paymentAccountId} The cardholder address information for the transaction.
clerkNumber false string An optional clerk number for reference.
configuration false POST_RequestConfiguration/v1/authorization/{paymentAccountId} Any value included in this section will override the corresponding value set in the triPOS.config
convenienceFeeAmount false double The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged
healthcare false POST_Healthcare/v1/authorization/{paymentAccountId} The healthcare section that contains all applicable healthcare-qualified amounts. more»
referenceNumber false string A user defined reference number.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
tipAmount false double The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
RequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
Healthcare
Field Required Data Type Description
clinic false double The total amount of healthcare-qualified goods that fall into the category of 'clinic'.
dental false double The total amount of healthcare-qualified goods that fall into the category of 'dental'.
prescription false double The total amount of healthcare-qualified goods that fall into the category of 'prescription'.
total false double The total amount of healthcare-qualified goods. If any healthcare values are included, this value is required to be present.
vision false double The total amount of healthcare-qualified goods that fall into the category of 'vision'.
PaymentAccountAuthorizationRequest 
{
  "laneId": {
    "description": "Specifies which lane to use for the card sale.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/authorization/{paymentAccountId}",
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_RequestConfiguration/v1/authorization/{paymentAccountId}",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged",
    "type": "double",
    "required": false
  },
  "healthcare": {
    "description": "The healthcare section that contains all applicable healthcare-qualified amounts. <a href='../help/kb/healthcare.html'>more&raquo;</a>",
    "type": "POST_Healthcare/v1/authorization/{paymentAccountId}",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.",
    "type": "double",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}
RequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  }
}
Healthcare 
{
  "clinic": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'clinic'.",
    "type": "double",
    "required": false
  },
  "dental": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'dental'.",
    "type": "double",
    "required": false
  },
  "prescription": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'prescription'.",
    "type": "double",
    "required": false
  },
  "total": {
    "description": "The total amount of healthcare-qualified goods. If any healthcare values are included, this value is required to be present.",
    "type": "double",
    "required": false
  },
  "vision": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'vision'.",
    "type": "double",
    "required": false
  }
}

Response Class

PaymentAccountAuthorizationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "approvalNumber": "string",
  "approvedAmount": "double",
  "avsResponseCode": "string",
  "cardLogo": "string",
  "convenienceFeeAmount": "double",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentAccountId": "string",
  "paymentAccountReferenceNumber": "string",
  "referenceNumber": "string",
  "statusCode": "string",
  "subTotalAmount": "double",
  "terminalId": "string",
  "tipAmount": "double",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
PaymentAccountAuthorizationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
approvedAmount false double The amount approved by the processor. This is the actual amount that will be charged or credited.
avsResponseCode false string The AVS response code.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
convenienceFeeAmount false double The convenience fee added to the transaction
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentAccountId false string The payment account ID.
paymentAccountReferenceNumber false string The payment account reference number.
referenceNumber false string The reference number.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
subTotalAmount false double The original amount sent for the transaction.
terminalId false string The ID of the terminal used during the transaction
tipAmount false double The tip amount added to the transaction.
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
PaymentAccountAuthorizationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "approvedAmount": {
    "description": "The amount approved by the processor. This is the actual amount that will be charged or credited.",
    "type": "double",
    "required": false
  },
  "avsResponseCode": {
    "description": "The AVS response code.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee added to the transaction",
    "type": "double",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentAccountId": {
    "description": "The payment account ID.",
    "type": "string",
    "required": false
  },
  "paymentAccountReferenceNumber": {
    "description": "The payment account reference number.",
    "type": "string",
    "required": false
  },
  "referenceNumber": {
    "description": "The reference number.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "subTotalAmount": {
    "description": "The original amount sent for the transaction.",
    "type": "double",
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount added to the transaction.",
    "type": "double",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
POST
/api/v1/authorization/{transactionId}/completion Updates a previous card authorization with the final totals

Implementation Notes

This completes the original authorization and initiates and exchange of funds. The transactionId is the value returned by the original authorization.

Parameters

Parameter Parameter Type Data Type Description
transactionId path string The ID of a previous authorization transaction.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
AuthorizationCompletionRequest body POST_AuthorizationCompletionRequest/v1/authorization/{transactionId}/completion undefined

Request Class

AuthorizationCompletionRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "commercialCardCustomerCode": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string",
    "promptForSignature": "string"
  },
  "convenienceFeeAmount": "double",
  "lodging": {
    "agreementNumber": "string",
    "chargeType": "string",
    "checkInDate": "string",
    "checkOutDate": "string",
    "customerName": "string",
    "duration": "int",
    "extraChargesDetail": "Array<POST_LodgingExtraChargesDetail/v1/authorization/{transactionId}/completion>",
    "noShow": "boolean",
    "prestigiousPropertyCode": "string",
    "roomAmount": "double",
    "specialProgramCode": "string"
  },
  "referenceNumber": "string",
  "salesTaxAmount": "double",
  "shiftId": "string",
  "ticketNumber": "string",
  "tipAmount": "double"
}
AuthorizationCompletionRequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string",
  "promptForSignature": "string"
}
AuthorizationCompletionRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
address false POST_Address/v1/authorization/{transactionId}/completion The cardholder address information for the transaction.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
commercialCardCustomerCode false string The commercial card customer code for the transaction. This is for Level II.
configuration false POST_AuthorizationCompletionRequestConfiguration/v1/authorization/{transactionId}/completion Any value included in this section will override the corresponding value set in the triPOS.config
convenienceFeeAmount false double The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged
lodging false POST_LodgingTransactionCompletion/v1/authorization/{transactionId}/completion The lodging parameters to be passed in for a lodging transaction. more»
referenceNumber false string A user defined reference number.
salesTaxAmount false double The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
tipAmount false double The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
AuthorizationCompletionRequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
promptForSignature false string Specifies how the signature prompt should be handled for the request. If a value is not provided, Never will be used. See Signature Prompt.
Values:
  • Always
  • Never
  • None
LodgingTransactionCompletion
Field Required Data Type Description
agreementNumber false string The lodging agreement number.
chargeType false string The lodging charge type. For an empty or invalid value, this parameter defaults to Default.
Values:
  • Default
  • Restaurant
  • GiftShop
checkInDate false string The check-in date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.
checkOutDate false string The check-out date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.
customerName false string The lodging customer name.
duration false int The number of hotel stay days. Set to 1 for no show.
extraChargesDetail false Array<POST_LodgingExtraChargesDetail/v1/authorization/{transactionId}/completion> Pass in up to 6 values that describe the extra charges. For an empty or invalid value, this parameter defaults to NotUsed.
Values:
  • NotUsed
  • Reserved
  • Restaurant
  • GiftShop
  • MiniBar
  • Telephone
  • Other
  • Laundry
noShow false boolean Set to true to indicate no show. Otherwise, value defaults to false.
prestigiousPropertyCode false string The lodging prestigious property code. For an empty or invalid value, this parameter defaults to NonParticipant.
Values:
  • NonParticipant
  • FiveHundredDollarLimit
  • OneThousandDollarLimit
  • OneThousandFiveHundredDollarLimit
roomAmount false double The nightly rate for one room.
specialProgramCode false string The lodging special program code. For an empty or invalid value, this parameter defaults to Default.
Values:
  • Default
  • Sale
  • NoShow
  • AdvanceDeposit
AuthorizationCompletionRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/authorization/{transactionId}/completion",
    "required": false
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "commercialCardCustomerCode": {
    "description": "The commercial card customer code for the transaction. This is for Level II.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_AuthorizationCompletionRequestConfiguration/v1/authorization/{transactionId}/completion",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged",
    "type": "double",
    "required": false
  },
  "lodging": {
    "description": "The lodging parameters to be passed in for a lodging transaction. <a href='../help/kb/lodging.html'>more&raquo;</a>",
    "type": "POST_LodgingTransactionCompletion/v1/authorization/{transactionId}/completion",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "salesTaxAmount": {
    "description": "The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.",
    "type": "double",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.",
    "type": "double",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}
AuthorizationCompletionRequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  },
  "promptForSignature": {
    "description": "Specifies how the signature prompt should be handled for the request. If a value is not provided, Never will be used. See <a href='../help/kb/signaturePrompt.html'>Signature Prompt</a>.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "None"
      ]
    },
    "required": false
  }
}
LodgingTransactionCompletion 
{
  "agreementNumber": {
    "description": "The lodging agreement number.",
    "type": "string",
    "required": false
  },
  "chargeType": {
    "description": "The lodging charge type. For an empty or invalid value, this parameter defaults to Default.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Restaurant",
        "GiftShop"
      ]
    },
    "required": false
  },
  "checkInDate": {
    "description": "The check-in date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.",
    "type": "string",
    "required": false
  },
  "checkOutDate": {
    "description": "The check-out date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.",
    "type": "string",
    "required": false
  },
  "customerName": {
    "description": "The lodging customer name.",
    "type": "string",
    "required": false
  },
  "duration": {
    "description": "The number of hotel stay days. Set to 1 for no show.",
    "type": "int",
    "required": false
  },
  "extraChargesDetail": {
    "description": "Pass in up to 6 values that describe the extra charges. For an empty or invalid value, this parameter defaults to NotUsed.",
    "type": "Array",
    "items": {
      "type": "POST_LodgingExtraChargesDetail/v1/authorization/{transactionId}/completion"
    },
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NotUsed",
        "Reserved",
        "Restaurant",
        "GiftShop",
        "MiniBar",
        "Telephone",
        "Other",
        "Laundry"
      ]
    },
    "required": false
  },
  "noShow": {
    "description": "Set to true to indicate no show. Otherwise, value defaults to false.",
    "type": "boolean",
    "required": false
  },
  "prestigiousPropertyCode": {
    "description": "The lodging prestigious property code. For an empty or invalid value, this parameter defaults to NonParticipant.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NonParticipant",
        "FiveHundredDollarLimit",
        "OneThousandDollarLimit",
        "OneThousandFiveHundredDollarLimit"
      ]
    },
    "required": false
  },
  "roomAmount": {
    "description": "The nightly rate for one room.",
    "type": "double",
    "required": false
  },
  "specialProgramCode": {
    "description": "The lodging special program code. For an empty or invalid value, this parameter defaults to Default.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Sale",
        "NoShow",
        "AdvanceDeposit"
      ]
    },
    "required": false
  }
}

Response Class

AuthorizationCompletionResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "approvedAmount": "double",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "convenienceFeeAmount": "double",
  "currencyCode": "string",
  "emv": {
    "applicationIdentifier": "string",
    "applicationLabel": "string",
    "applicationPreferredName": "string",
    "cryptogram": "string",
    "issuerCodeTableIndex": "string",
    "tags": {
      "key": "string",
      "value": "string"
    }
  },
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "fsaCard": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentType": "string",
  "pinVerified": "boolean",
  "signature": {
    "data": "Array<byte>",
    "format": "string",
    "statusCode": "string"
  },
  "statusCode": "string",
  "subTotalAmount": "double",
  "terminalId": "string",
  "tipAmount": "double",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
AuthorizationCompletionResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
approvedAmount false double The amount approved by the processor. This is the actual amount that will be charged or credited.
binValue false string The BIN entry that matched the account number.
cardHolderName false string The cardholder name.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
convenienceFeeAmount false double The convenience fee added to the transaction
currencyCode false string The currency code used in the transaction.
Values:
  • None
  • Usd
emv false Emv The fields used on the receipt for an EMV transaction. Null if the transaction was not EMV.
entryMode false string Description of how card was entered.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
fsaCard false string Indicates whether the card used was a FSA card.
Note: Maybe = No BIN entry to determine if FSA.
Values:
  • NotApplicable
  • No
  • Yes
  • Maybe
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentType false string Description of payment type utilized.
Values:
  • None
  • Credit
  • Debit
  • Gift
pinVerified false boolean True if the PIN was verified, false if not verified or undetermined.
signature false Signature The signature data.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
subTotalAmount false double The original amount sent for the transaction.
terminalId false string The ID of the terminal used during the transaction
tipAmount false double The tip amount added to the transaction.
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Emv
Field Required Data Type Description
applicationIdentifier false string The Application Identifier also known as the AID. Identifies the application as described in ISO/IEC 7816-5. Printed receipts are required to contain the AID as hexadecimal characters.
applicationLabel false string Mnemonic associated with the AID according to ISO/IEC 7816-5. If the Application Preferred Name is not available or the Issuer code table index is not supported, then the Application Label should be used on the receipt instead of the Application Preferred Name.
applicationPreferredName false string Preferred mnemonic associated with the AID. When the Application Preferred Name is present and the Issuer code table index is supported, then this data element is mandatory on the receipt.
cryptogram false string The EMV cryptogram type and value. It is a preferred best practice to include this data element on the receipt, but is not mandatory. This field contains cryptogram type followed by the cryptogram value.
issuerCodeTableIndex false string Indicates the code table according to ISO/IEC 8859 for displaying the Application Preferred Name.
tags false Array<Tag> A name value collection of additional EMV tags that are required to appear on the receipt.
Tag
Field Required Data Type Description
key false string undefined
value false string undefined
Signature
Field Required Data Type Description
data false Array<byte> The byte array of the signature in the format specified by Format.
format false string The format of the signature.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
statusCode false string Indicates why a signature is or is not present.
Values:
  • Unknown
  • SignatureRequired
  • SignaturePresent
  • SignatureRequiredCancelledByCardholder
  • SignatureRequiredNotSupportedByPinPad
  • SignatureRequiredPinPadError
  • SignatureNotRequiredByThresholdAmount
  • SignatureNotRequiredByPaymentType
  • SignatureNotRequiredByTransactionType
  • SignatureRequiredButPromptSuppressedByMerchant
AuthorizationCompletionResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "approvedAmount": {
    "description": "The amount approved by the processor. This is the actual amount that will be charged or credited.",
    "type": "double",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The cardholder name.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee added to the transaction",
    "type": "double",
    "required": false
  },
  "currencyCode": {
    "description": "The currency code used in the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": false
  },
  "emv": {
    "description": "The fields used on the receipt for an EMV transaction. Null if the transaction was not EMV.",
    "type": "Emv",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "fsaCard": {
    "description": "Indicates whether the card used was a FSA card.<br />Note: Maybe = No BIN entry to determine if FSA.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NotApplicable",
        "No",
        "Yes",
        "Maybe"
      ]
    },
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentType": {
    "description": "Description of payment type utilized.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Credit",
        "Debit",
        "Gift"
      ]
    },
    "required": false
  },
  "pinVerified": {
    "description": "True if the PIN was verified, false if not verified or undetermined.",
    "type": "boolean",
    "required": false
  },
  "signature": {
    "description": "The signature data.",
    "type": "Signature",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "subTotalAmount": {
    "description": "The original amount sent for the transaction.",
    "type": "double",
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount added to the transaction.",
    "type": "double",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Emv 
{
  "applicationIdentifier": {
    "description": "The Application Identifier also known as the AID. Identifies the application as described in ISO/IEC 7816-5. Printed receipts are required to contain the AID as hexadecimal characters.",
    "type": "string",
    "required": false
  },
  "applicationLabel": {
    "description": "Mnemonic associated with the AID according to ISO/IEC 7816-5. If the Application Preferred Name is not available or the Issuer code table index is not supported, then the Application Label should be used on the receipt instead of the Application Preferred Name.",
    "type": "string",
    "required": false
  },
  "applicationPreferredName": {
    "description": "Preferred mnemonic associated with the AID. When the Application Preferred Name is present and the Issuer code table index is supported, then this data element is mandatory on the receipt.",
    "type": "string",
    "required": false
  },
  "cryptogram": {
    "description": "The EMV cryptogram type and value. It is a preferred best practice to include this data element on the receipt, but is not mandatory. This field contains cryptogram type followed by the cryptogram value.",
    "type": "string",
    "required": false
  },
  "issuerCodeTableIndex": {
    "description": "Indicates the code table according to ISO/IEC 8859 for displaying the Application Preferred Name.",
    "type": "string",
    "required": false
  },
  "tags": {
    "description": "A name value collection of additional EMV tags that are required to appear on the receipt.",
    "type": "Array",
    "items": {
      "$ref": "Tag"
    },
    "required": false
  }
}
Tag 
{
  "key": {
    "type": "string",
    "required": false
  },
  "value": {
    "type": "string",
    "required": false
  }
}
Signature 
{
  "data": {
    "description": "The byte array of the signature in the format specified by Format.",
    "type": "Array",
    "items": {
      "type": "byte"
    },
    "required": false
  },
  "format": {
    "description": "The format of the signature.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "statusCode": {
    "description": "Indicates why a signature is or is not present.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "SignatureRequired",
        "SignaturePresent",
        "SignatureRequiredCancelledByCardholder",
        "SignatureRequiredNotSupportedByPinPad",
        "SignatureRequiredPinPadError",
        "SignatureNotRequiredByThresholdAmount",
        "SignatureNotRequiredByPaymentType",
        "SignatureNotRequiredByTransactionType",
        "SignatureRequiredButPromptSuppressedByMerchant"
      ]
    },
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if MarketCode is not HotelLodging but the request includes lodging parameters on a valid lodging request.
400 Returned if the lodging checkInDate or checkOutDate is not in the ISO 8601 format of YYYY-MM-DD on a valid lodging request.
400 Returned if the lodging roomAmount is less than 0.00 on a valid lodging request.
400 Returned if the lodging duration is less than 0 on a valid lodging request.
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
POST
/api/v1/authorization/{transactionId}/incremental Increases a previous card authorization by the given transactionAmount

Implementation Notes

This increments the original authorization by the given transactionAmount. The transactionId is the value returned by the original authorization. More»

Parameters

Parameter Parameter Type Data Type Description
transactionId path string The ID of a previous authorization transaction.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
IncrementalAuthorizationRequest body POST_IncrementalAuthorizationRequest/v1/authorization/{transactionId}/incremental undefined

Request Class

IncrementalAuthorizationRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "configuration": {
    "marketCode": "string"
  },
  "lodging": {
    "duration": "int"
  },
  "referenceNumber": "string",
  "shiftId": "string",
  "ticketNumber": "string"
}
TransactionIdRequestConfiguration 
{
  "marketCode": "string"
}
IncrementalAuthorizationRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
transactionAmount true double The amount by which to increase the authorization amount.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
configuration false POST_TransactionIdRequestConfiguration/v1/authorization/{transactionId}/incremental Applicable configuration values that can be set per request.
lodging false POST_LodgingIncrementalAuthorization/v1/authorization/{transactionId}/incremental The lodging parameter to be passed in for a lodging transaction. more»
referenceNumber false string A user defined reference number.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
TransactionIdRequestConfiguration
Field Required Data Type Description
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
LodgingIncrementalAuthorization
Field Required Data Type Description
duration false int The number of hotel stay days. Set to 1 for no show.
IncrementalAuthorizationRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The amount by which to increase the authorization amount.",
    "type": "double",
    "required": true
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Applicable configuration values that can be set per request.",
    "type": "POST_TransactionIdRequestConfiguration/v1/authorization/{transactionId}/incremental",
    "required": false
  },
  "lodging": {
    "description": "The lodging parameter to be passed in for a lodging transaction. <a href='../help/kb/lodging.html'>more&raquo;</a>",
    "type": "POST_LodgingIncrementalAuthorization/v1/authorization/{transactionId}/incremental",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  }
}
TransactionIdRequestConfiguration 
{
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  }
}
LodgingIncrementalAuthorization 
{
  "duration": {
    "description": "The number of hotel stay days. Set to 1 for no show.",
    "type": "int",
    "required": false
  }
}

Response Class

IncrementalAuthorizationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "cardLogo": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "marketCode": "string",
  "merchantId": "string",
  "referenceNumber": "string",
  "statusCode": "string",
  "terminalId": "string",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
IncrementalAuthorizationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
marketCode false string The transaction's reference number.
merchantId false string The Merchant used to process the transaction.
referenceNumber false string The transaction's reference number.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
IncrementalAuthorizationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The transaction's reference number.",
    "type": "string",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "referenceNumber": {
    "description": "The transaction's reference number.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if the laneId, transactionId or transactionAmount are missing from the request.
400 Returned if the triPOS.config marketCode AND the request configuration marketCode are both null or default. One must be set to a non-default value.
400 Returned if your MarketCode is not HotelLodging but your request includes lodging parameters.
400 Returned if the lodging duration is less than 0 on a valid lodging request.
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
POST
/api/v1/balance Requests a balance for a gift card

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
BalanceRequest body POST_BalanceRequest/v1/balance undefined

Request Class

BalanceRequest 
{
  "laneId": "int",
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string"
  },
  "referenceNumber": "string",
  "shiftId": "string",
  "ticketNumber": "string"
}
RequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string"
}
BalanceRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
configuration false POST_RequestConfiguration/v1/balance Any value included in this section will override the corresponding value set in the triPOS.config
referenceNumber false string A user defined reference number.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
RequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
BalanceRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_RequestConfiguration/v1/balance",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  }
}
RequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  }
}

Response Class

BalanceResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "balanceAmount": "double",
  "balanceCurrencyCode": "string",
  "binValue": "string",
  "cardLogo": "string",
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentType": "string",
  "statusCode": "string",
  "terminalId": "string",
  "transactionDateTime": "string",
  "transactionId": "string"
}
BalanceResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
balanceAmount false double The balance of the gift card.
balanceCurrencyCode false string The balance currency code.
binValue false string The BIN entry that matched the account number.
cardLogo false string The card logo (e.g. Visa, Mastercard, etc).
entryMode false string Description of how card was entered: Keyed, Swiped, Chip.
expirationMonth false string The card's expiration month. NOTE: Not all cards that support balance inquiry will have an expiration date.
expirationYear false string The card's expiration year. NOTE: Not all cards that support balance inquiry will have an expiration date.
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentType false string Description of how card payment type: None, Credit, Debit.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
BalanceResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "balanceAmount": {
    "description": "The balance of the gift card.",
    "type": "double",
    "required": false
  },
  "balanceCurrencyCode": {
    "description": "The balance currency code.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo (e.g. Visa, Mastercard, etc).",
    "type": "string",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered: Keyed, Swiped, Chip.",
    "type": "string",
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month. NOTE: Not all cards that support balance inquiry will have an expiration date.",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year. NOTE: Not all cards that support balance inquiry will have an expiration date.",
    "type": "string",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentType": {
    "description": "Description of how card payment type: None, Credit, Debit.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
GET
/api/v1/binQuery/{laneId} Determine if a card falls into a specific BIN range such as prepaid, healthcare, or debit

Implementation Notes

Use the GET /binQuery/{laneId} endpoint to determine if a card falls into a specific BIN range such as prepaid, healthcare, or debit. The BIN query endpoint always makes an online call to the host in order to ensure the most up-to-date BIN information. If the card swiped or inserted is not found in the online BIN table, this endpoint returns a 404 Not Found HTTP response.

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

BinQueryResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "check": "boolean",
  "commercial": "boolean",
  "credit": "boolean",
  "debit": "boolean",
  "durbinBinRegulation": "string",
  "ebt": "boolean",
  "fleet": "boolean",
  "gift": "boolean",
  "hsaFsa": "boolean",
  "internationalBin": "boolean",
  "pinlessBillPay": "boolean",
  "prepaid": "boolean",
  "wic": "boolean"
}
BinQueryResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
check false boolean Check card indicator
commercial false boolean Commercial card indicator
credit false boolean Credit card indicator
debit false boolean Debit card indicator
durbinBinRegulation false string Durbin BIN Regulation indicator
Values:
  • Unknown
  • NotRegulated
  • Regulated
  • RegulatedWithFraudAdj
  • NotRegulatedPreferred
  • RegulatedPreferred
  • RegulatedWithFraudAdjPreferred
ebt false boolean EBT card indicator
fleet false boolean Fleet card indicator
gift false boolean Gift card indicator
hsaFsa false boolean HSA/FSA card indicator
internationalBin false boolean International BIN indicator
pinlessBillPay false boolean PINless Bill Pay indicator
prepaid false boolean Prepaid card indicator
wic false boolean WIC card indicator
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
BinQueryResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "check": {
    "description": "Check card indicator",
    "type": "boolean",
    "required": false
  },
  "commercial": {
    "description": "Commercial card indicator",
    "type": "boolean",
    "required": false
  },
  "credit": {
    "description": "Credit card indicator",
    "type": "boolean",
    "required": false
  },
  "debit": {
    "description": "Debit card indicator",
    "type": "boolean",
    "required": false
  },
  "durbinBinRegulation": {
    "description": "Durbin BIN Regulation indicator",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "NotRegulated",
        "Regulated",
        "RegulatedWithFraudAdj",
        "NotRegulatedPreferred",
        "RegulatedPreferred",
        "RegulatedWithFraudAdjPreferred"
      ]
    },
    "required": false
  },
  "ebt": {
    "description": "EBT card indicator",
    "type": "boolean",
    "required": false
  },
  "fleet": {
    "description": "Fleet card indicator",
    "type": "boolean",
    "required": false
  },
  "gift": {
    "description": "Gift card indicator",
    "type": "boolean",
    "required": false
  },
  "hsaFsa": {
    "description": "HSA/FSA card indicator",
    "type": "boolean",
    "required": false
  },
  "internationalBin": {
    "description": "International BIN indicator",
    "type": "boolean",
    "required": false
  },
  "pinlessBillPay": {
    "description": "PINless Bill Pay indicator",
    "type": "boolean",
    "required": false
  },
  "prepaid": {
    "description": "Prepaid card indicator",
    "type": "boolean",
    "required": false
  },
  "wic": {
    "description": "WIC card indicator",
    "type": "boolean",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
404 Returned if card is not found in the BIN table
GET
/api/v1/card Return a list of the triPOS Card endpoints

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

CardResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "cardType": "string",
  "financialCard": {
    "accountNumber": "string",
    "binValue": "string",
    "cardEntryMode": "string",
    "cardholderName": "string",
    "cardLogo": "string",
    "encryptedCardData": {
      "cardDataKeySerialNumber": "string",
      "cardNumberMasked": "string",
      "cvv": "string",
      "encryptedFormat": "string",
      "encryptedManualKeyedCardData": "string",
      "encryptedTrack1Data": "string",
      "encryptedTrack2Data": "string",
      "keySerialNumber": "string",
      "magneprintData": "string",
      "pinBlock": "string",
      "track1Data": "string",
      "track2Data": "string",
      "track3Data": "string"
    },
    "expirationMonth": "string",
    "expirationYear": "string"
  },
  "nonFinancialCard": {
    "cardEntryMode": "string",
    "track1": "string",
    "track2": "string",
    "track3": "string"
  }
}
CardResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
cardType false string Indidcates whether the card read was a financial or non-financial card.
Values:
  • Unknown
  • Financial
  • NonFinancial
financialCard false FinancialCard Fields for a financial card response. These fields are populated if the card read was a financial card.
nonFinancialCard false NonFinancialCard Fields for a non-financial card response. These fields are populated if the card read was a non-financial card.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
FinancialCard
Field Required Data Type Description
accountNumber false string The card account number.
binValue false string The BIN entry that matched the account number.
cardEntryMode false string Card entry mode
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
cardholderName false string The name of the cardholder as printed on the front of the card
cardLogo false string Brand of the card. Possible values include: Visa, Mastercard, Discover
encryptedCardData false EncryptedCardData The encrypted card data
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
EncryptedCardData
Field Required Data Type Description
cardDataKeySerialNumber false string Encrypted card data key serial number.
cardNumberMasked false string The masked card number.
cvv false string Card verification value found on the card.
encryptedFormat false string The format of the encrypted manual keyed card data.
Values:
  • Default
  • Format1
  • Format2
  • Format3
  • Format4
  • Format5
  • Format6
  • Format7
encryptedManualKeyedCardData false string Encrypted manually keyed card data.
encryptedTrack1Data false string Encrypted swiped track 1 data.
encryptedTrack2Data false string Encrypted swiped track 2 data.
keySerialNumber false string PIN key serial number.
magneprintData false string Raw output of certain devices directly supported by Express.
pinBlock false string Encrypted PIN block information sent from the PIN encryption device.
track1Data false string Clear text swiped track 1 data.
track2Data false string Clear text swiped track 2 data.
track3Data false string Clear text swiped track 3 data.
NonFinancialCard
Field Required Data Type Description
cardEntryMode false string Card entry mode
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
track1 false string Track 1 of the non-financial card
track2 false string Track 2 of the non-financial card
track3 false string Track 3 of the non-financial card
CardResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "cardType": {
    "description": "Indidcates whether the card read was a financial or non-financial card.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Financial",
        "NonFinancial"
      ]
    },
    "required": false
  },
  "financialCard": {
    "description": "Fields for a financial card response. These fields are populated if the card read was a financial card.",
    "type": "FinancialCard",
    "required": false
  },
  "nonFinancialCard": {
    "description": "Fields for a non-financial card response. These fields are populated if the card read was a non-financial card.",
    "type": "NonFinancialCard",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
FinancialCard 
{
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardEntryMode": {
    "description": "Card entry mode",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "cardholderName": {
    "description": "The name of the cardholder as printed on the front of the card",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "Brand of the card. Possible values include: Visa, Mastercard, Discover",
    "type": "string",
    "required": false
  },
  "encryptedCardData": {
    "description": "The encrypted card data",
    "type": "EncryptedCardData",
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  }
}
EncryptedCardData 
{
  "cardDataKeySerialNumber": {
    "description": "Encrypted card data key serial number.",
    "type": "string",
    "required": false
  },
  "cardNumberMasked": {
    "description": "The masked card number.",
    "type": "string",
    "required": false
  },
  "cvv": {
    "description": "Card verification value found on the card.",
    "type": "string",
    "required": false
  },
  "encryptedFormat": {
    "description": "The format of the encrypted manual keyed card data.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Format1",
        "Format2",
        "Format3",
        "Format4",
        "Format5",
        "Format6",
        "Format7"
      ]
    },
    "required": false
  },
  "encryptedManualKeyedCardData": {
    "description": "Encrypted manually keyed card data.",
    "type": "string",
    "required": false
  },
  "encryptedTrack1Data": {
    "description": "Encrypted swiped track 1 data.",
    "type": "string",
    "required": false
  },
  "encryptedTrack2Data": {
    "description": "Encrypted swiped track 2 data.",
    "type": "string",
    "required": false
  },
  "keySerialNumber": {
    "description": "PIN key serial number.",
    "type": "string",
    "required": false
  },
  "magneprintData": {
    "description": "Raw output of certain devices directly supported by Express.",
    "type": "string",
    "required": false
  },
  "pinBlock": {
    "description": "Encrypted PIN block information sent from the PIN encryption device.",
    "type": "string",
    "required": false
  },
  "track1Data": {
    "description": "Clear text swiped track 1 data.",
    "type": "string",
    "required": false
  },
  "track2Data": {
    "description": "Clear text swiped track 2 data.",
    "type": "string",
    "required": false
  },
  "track3Data": {
    "description": "Clear text swiped track 3 data.",
    "type": "string",
    "required": false
  }
}
NonFinancialCard 
{
  "cardEntryMode": {
    "description": "Card entry mode",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "track1": {
    "description": "Track 1 of the non-financial card",
    "type": "string",
    "required": false
  },
  "track2": {
    "description": "Track 2 of the non-financial card",
    "type": "string",
    "required": false
  },
  "track3": {
    "description": "Track 3 of the non-financial card",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/card/{laneId} Get card info

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
isEncryptedDataNeeded query boolean The flag that indicates if encrypted card data needs to be obtained.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

CardResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "cardType": "string",
  "financialCard": {
    "accountNumber": "string",
    "binValue": "string",
    "cardEntryMode": "string",
    "cardholderName": "string",
    "cardLogo": "string",
    "encryptedCardData": {
      "cardDataKeySerialNumber": "string",
      "cardNumberMasked": "string",
      "cvv": "string",
      "encryptedFormat": "string",
      "encryptedManualKeyedCardData": "string",
      "encryptedTrack1Data": "string",
      "encryptedTrack2Data": "string",
      "keySerialNumber": "string",
      "magneprintData": "string",
      "pinBlock": "string",
      "track1Data": "string",
      "track2Data": "string",
      "track3Data": "string"
    },
    "expirationMonth": "string",
    "expirationYear": "string"
  },
  "nonFinancialCard": {
    "cardEntryMode": "string",
    "track1": "string",
    "track2": "string",
    "track3": "string"
  }
}
CardResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
cardType false string Indidcates whether the card read was a financial or non-financial card.
Values:
  • Unknown
  • Financial
  • NonFinancial
financialCard false FinancialCard Fields for a financial card response. These fields are populated if the card read was a financial card.
nonFinancialCard false NonFinancialCard Fields for a non-financial card response. These fields are populated if the card read was a non-financial card.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
FinancialCard
Field Required Data Type Description
accountNumber false string The card account number.
binValue false string The BIN entry that matched the account number.
cardEntryMode false string Card entry mode
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
cardholderName false string The name of the cardholder as printed on the front of the card
cardLogo false string Brand of the card. Possible values include: Visa, Mastercard, Discover
encryptedCardData false EncryptedCardData The encrypted card data
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
EncryptedCardData
Field Required Data Type Description
cardDataKeySerialNumber false string Encrypted card data key serial number.
cardNumberMasked false string The masked card number.
cvv false string Card verification value found on the card.
encryptedFormat false string The format of the encrypted manual keyed card data.
Values:
  • Default
  • Format1
  • Format2
  • Format3
  • Format4
  • Format5
  • Format6
  • Format7
encryptedManualKeyedCardData false string Encrypted manually keyed card data.
encryptedTrack1Data false string Encrypted swiped track 1 data.
encryptedTrack2Data false string Encrypted swiped track 2 data.
keySerialNumber false string PIN key serial number.
magneprintData false string Raw output of certain devices directly supported by Express.
pinBlock false string Encrypted PIN block information sent from the PIN encryption device.
track1Data false string Clear text swiped track 1 data.
track2Data false string Clear text swiped track 2 data.
track3Data false string Clear text swiped track 3 data.
NonFinancialCard
Field Required Data Type Description
cardEntryMode false string Card entry mode
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
track1 false string Track 1 of the non-financial card
track2 false string Track 2 of the non-financial card
track3 false string Track 3 of the non-financial card
CardResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "cardType": {
    "description": "Indidcates whether the card read was a financial or non-financial card.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Financial",
        "NonFinancial"
      ]
    },
    "required": false
  },
  "financialCard": {
    "description": "Fields for a financial card response. These fields are populated if the card read was a financial card.",
    "type": "FinancialCard",
    "required": false
  },
  "nonFinancialCard": {
    "description": "Fields for a non-financial card response. These fields are populated if the card read was a non-financial card.",
    "type": "NonFinancialCard",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
FinancialCard 
{
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardEntryMode": {
    "description": "Card entry mode",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "cardholderName": {
    "description": "The name of the cardholder as printed on the front of the card",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "Brand of the card. Possible values include: Visa, Mastercard, Discover",
    "type": "string",
    "required": false
  },
  "encryptedCardData": {
    "description": "The encrypted card data",
    "type": "EncryptedCardData",
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  }
}
EncryptedCardData 
{
  "cardDataKeySerialNumber": {
    "description": "Encrypted card data key serial number.",
    "type": "string",
    "required": false
  },
  "cardNumberMasked": {
    "description": "The masked card number.",
    "type": "string",
    "required": false
  },
  "cvv": {
    "description": "Card verification value found on the card.",
    "type": "string",
    "required": false
  },
  "encryptedFormat": {
    "description": "The format of the encrypted manual keyed card data.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Format1",
        "Format2",
        "Format3",
        "Format4",
        "Format5",
        "Format6",
        "Format7"
      ]
    },
    "required": false
  },
  "encryptedManualKeyedCardData": {
    "description": "Encrypted manually keyed card data.",
    "type": "string",
    "required": false
  },
  "encryptedTrack1Data": {
    "description": "Encrypted swiped track 1 data.",
    "type": "string",
    "required": false
  },
  "encryptedTrack2Data": {
    "description": "Encrypted swiped track 2 data.",
    "type": "string",
    "required": false
  },
  "keySerialNumber": {
    "description": "PIN key serial number.",
    "type": "string",
    "required": false
  },
  "magneprintData": {
    "description": "Raw output of certain devices directly supported by Express.",
    "type": "string",
    "required": false
  },
  "pinBlock": {
    "description": "Encrypted PIN block information sent from the PIN encryption device.",
    "type": "string",
    "required": false
  },
  "track1Data": {
    "description": "Clear text swiped track 1 data.",
    "type": "string",
    "required": false
  },
  "track2Data": {
    "description": "Clear text swiped track 2 data.",
    "type": "string",
    "required": false
  },
  "track3Data": {
    "description": "Clear text swiped track 3 data.",
    "type": "string",
    "required": false
  }
}
NonFinancialCard 
{
  "cardEntryMode": {
    "description": "Card entry mode",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "track1": {
    "description": "Track 1 of the non-financial card",
    "type": "string",
    "required": false
  },
  "track2": {
    "description": "Track 2 of the non-financial card",
    "type": "string",
    "required": false
  },
  "track3": {
    "description": "Track 3 of the non-financial card",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
404 If no data can be found when the card is swiped, tripos returns an HTTP status code of 404.
GET
/api/v1/card/financial Return a list of the triPOS FinancialCard endpoints

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

FinancialCardResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "binValue": "string",
  "cardEntryMode": "string",
  "cardholderName": "string",
  "cardLogo": "string",
  "encryptedCardData": {
    "cardDataKeySerialNumber": "string",
    "cardNumberMasked": "string",
    "cvv": "string",
    "encryptedFormat": "string",
    "encryptedManualKeyedCardData": "string",
    "encryptedTrack1Data": "string",
    "encryptedTrack2Data": "string",
    "keySerialNumber": "string",
    "magneprintData": "string",
    "pinBlock": "string",
    "track1Data": "string",
    "track2Data": "string",
    "track3Data": "string"
  },
  "expirationMonth": "string",
  "expirationYear": "string"
}
FinancialCardResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
binValue false string The BIN entry that matched the account number.
cardEntryMode false string Card entry mode
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
cardholderName false string The name of the cardholder as printed on the front of the card
cardLogo false string Brand of the card. Possible values include: Visa, Mastercard, Discover
encryptedCardData false EncryptedCardData The encrypted card data
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
EncryptedCardData
Field Required Data Type Description
cardDataKeySerialNumber false string Encrypted card data key serial number.
cardNumberMasked false string The masked card number.
cvv false string Card verification value found on the card.
encryptedFormat false string The format of the encrypted manual keyed card data.
Values:
  • Default
  • Format1
  • Format2
  • Format3
  • Format4
  • Format5
  • Format6
  • Format7
encryptedManualKeyedCardData false string Encrypted manually keyed card data.
encryptedTrack1Data false string Encrypted swiped track 1 data.
encryptedTrack2Data false string Encrypted swiped track 2 data.
keySerialNumber false string PIN key serial number.
magneprintData false string Raw output of certain devices directly supported by Express.
pinBlock false string Encrypted PIN block information sent from the PIN encryption device.
track1Data false string Clear text swiped track 1 data.
track2Data false string Clear text swiped track 2 data.
track3Data false string Clear text swiped track 3 data.
FinancialCardResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardEntryMode": {
    "description": "Card entry mode",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "cardholderName": {
    "description": "The name of the cardholder as printed on the front of the card",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "Brand of the card. Possible values include: Visa, Mastercard, Discover",
    "type": "string",
    "required": false
  },
  "encryptedCardData": {
    "description": "The encrypted card data",
    "type": "EncryptedCardData",
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
EncryptedCardData 
{
  "cardDataKeySerialNumber": {
    "description": "Encrypted card data key serial number.",
    "type": "string",
    "required": false
  },
  "cardNumberMasked": {
    "description": "The masked card number.",
    "type": "string",
    "required": false
  },
  "cvv": {
    "description": "Card verification value found on the card.",
    "type": "string",
    "required": false
  },
  "encryptedFormat": {
    "description": "The format of the encrypted manual keyed card data.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Format1",
        "Format2",
        "Format3",
        "Format4",
        "Format5",
        "Format6",
        "Format7"
      ]
    },
    "required": false
  },
  "encryptedManualKeyedCardData": {
    "description": "Encrypted manually keyed card data.",
    "type": "string",
    "required": false
  },
  "encryptedTrack1Data": {
    "description": "Encrypted swiped track 1 data.",
    "type": "string",
    "required": false
  },
  "encryptedTrack2Data": {
    "description": "Encrypted swiped track 2 data.",
    "type": "string",
    "required": false
  },
  "keySerialNumber": {
    "description": "PIN key serial number.",
    "type": "string",
    "required": false
  },
  "magneprintData": {
    "description": "Raw output of certain devices directly supported by Express.",
    "type": "string",
    "required": false
  },
  "pinBlock": {
    "description": "Encrypted PIN block information sent from the PIN encryption device.",
    "type": "string",
    "required": false
  },
  "track1Data": {
    "description": "Clear text swiped track 1 data.",
    "type": "string",
    "required": false
  },
  "track2Data": {
    "description": "Clear text swiped track 2 data.",
    "type": "string",
    "required": false
  },
  "track3Data": {
    "description": "Clear text swiped track 3 data.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/card/financial/{laneId} Get financial card info

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
isEncryptedDataNeeded query boolean The flag that indicates if encrypted card data needs to be obtained.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

FinancialCardResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "binValue": "string",
  "cardEntryMode": "string",
  "cardholderName": "string",
  "cardLogo": "string",
  "encryptedCardData": {
    "cardDataKeySerialNumber": "string",
    "cardNumberMasked": "string",
    "cvv": "string",
    "encryptedFormat": "string",
    "encryptedManualKeyedCardData": "string",
    "encryptedTrack1Data": "string",
    "encryptedTrack2Data": "string",
    "keySerialNumber": "string",
    "magneprintData": "string",
    "pinBlock": "string",
    "track1Data": "string",
    "track2Data": "string",
    "track3Data": "string"
  },
  "expirationMonth": "string",
  "expirationYear": "string"
}
FinancialCardResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
binValue false string The BIN entry that matched the account number.
cardEntryMode false string Card entry mode
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
cardholderName false string The name of the cardholder as printed on the front of the card
cardLogo false string Brand of the card. Possible values include: Visa, Mastercard, Discover
encryptedCardData false EncryptedCardData The encrypted card data
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
EncryptedCardData
Field Required Data Type Description
cardDataKeySerialNumber false string Encrypted card data key serial number.
cardNumberMasked false string The masked card number.
cvv false string Card verification value found on the card.
encryptedFormat false string The format of the encrypted manual keyed card data.
Values:
  • Default
  • Format1
  • Format2
  • Format3
  • Format4
  • Format5
  • Format6
  • Format7
encryptedManualKeyedCardData false string Encrypted manually keyed card data.
encryptedTrack1Data false string Encrypted swiped track 1 data.
encryptedTrack2Data false string Encrypted swiped track 2 data.
keySerialNumber false string PIN key serial number.
magneprintData false string Raw output of certain devices directly supported by Express.
pinBlock false string Encrypted PIN block information sent from the PIN encryption device.
track1Data false string Clear text swiped track 1 data.
track2Data false string Clear text swiped track 2 data.
track3Data false string Clear text swiped track 3 data.
FinancialCardResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardEntryMode": {
    "description": "Card entry mode",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "cardholderName": {
    "description": "The name of the cardholder as printed on the front of the card",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "Brand of the card. Possible values include: Visa, Mastercard, Discover",
    "type": "string",
    "required": false
  },
  "encryptedCardData": {
    "description": "The encrypted card data",
    "type": "EncryptedCardData",
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
EncryptedCardData 
{
  "cardDataKeySerialNumber": {
    "description": "Encrypted card data key serial number.",
    "type": "string",
    "required": false
  },
  "cardNumberMasked": {
    "description": "The masked card number.",
    "type": "string",
    "required": false
  },
  "cvv": {
    "description": "Card verification value found on the card.",
    "type": "string",
    "required": false
  },
  "encryptedFormat": {
    "description": "The format of the encrypted manual keyed card data.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Format1",
        "Format2",
        "Format3",
        "Format4",
        "Format5",
        "Format6",
        "Format7"
      ]
    },
    "required": false
  },
  "encryptedManualKeyedCardData": {
    "description": "Encrypted manually keyed card data.",
    "type": "string",
    "required": false
  },
  "encryptedTrack1Data": {
    "description": "Encrypted swiped track 1 data.",
    "type": "string",
    "required": false
  },
  "encryptedTrack2Data": {
    "description": "Encrypted swiped track 2 data.",
    "type": "string",
    "required": false
  },
  "keySerialNumber": {
    "description": "PIN key serial number.",
    "type": "string",
    "required": false
  },
  "magneprintData": {
    "description": "Raw output of certain devices directly supported by Express.",
    "type": "string",
    "required": false
  },
  "pinBlock": {
    "description": "Encrypted PIN block information sent from the PIN encryption device.",
    "type": "string",
    "required": false
  },
  "track1Data": {
    "description": "Clear text swiped track 1 data.",
    "type": "string",
    "required": false
  },
  "track2Data": {
    "description": "Clear text swiped track 2 data.",
    "type": "string",
    "required": false
  },
  "track3Data": {
    "description": "Clear text swiped track 3 data.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
404 Returned if no financial data can be found when the card is swiped.
GET
/api/v1/card/nonfinancial Return a list of the triPOS NonFinancialCard endpoints

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

NonFinancialCardResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "cardEntryMode": "string",
  "track1": "string",
  "track2": "string",
  "track3": "string"
}
NonFinancialCardResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
cardEntryMode false string Card entry mode
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
track1 false string Track 1 of the non-financial card
track2 false string Track 2 of the non-financial card
track3 false string Track 3 of the non-financial card
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
NonFinancialCardResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "cardEntryMode": {
    "description": "Card entry mode",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "track1": {
    "description": "Track 1 of the non-financial card",
    "type": "string",
    "required": false
  },
  "track2": {
    "description": "Track 2 of the non-financial card",
    "type": "string",
    "required": false
  },
  "track3": {
    "description": "Track 3 of the non-financial card",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/card/nonfinancial/{laneId} Get non-financial card info

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

NonFinancialCardResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "cardEntryMode": "string",
  "track1": "string",
  "track2": "string",
  "track3": "string"
}
NonFinancialCardResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
cardEntryMode false string Card entry mode
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
track1 false string Track 1 of the non-financial card
track2 false string Track 2 of the non-financial card
track3 false string Track 3 of the non-financial card
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
NonFinancialCardResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "cardEntryMode": {
    "description": "Card entry mode",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "track1": {
    "description": "Track 1 of the non-financial card",
    "type": "string",
    "required": false
  },
  "track2": {
    "description": "Track 2 of the non-financial card",
    "type": "string",
    "required": false
  },
  "track3": {
    "description": "Track 3 of the non-financial card",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
404 If no 'non-financial' data can be found when the card is swiped, tripos returns an HTTP status code of 404.
GET
/api/v1/configuration Retrieve the HATEOAS links for accessing and modifying the triPOS configuration

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

ConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
ConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
ConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/configuration/application Retrieve application settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetApplicationConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "binFileName": "string",
  "corsAllowedOrigins": "string",
  "pinPadIdleMessage": "string",
  "testMode": "string"
}
GetApplicationConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
binFileName false string Location of BIN files to be loaded from disk
corsAllowedOrigins false string Sets the origins allowed to submit requests to triPOS
pinPadIdleMessage false string Message to display on the PIN pad when it is idle.
testMode false string Set to 'true' to be in Test/Certification mode or 'false' for Production mode.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
GetApplicationConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "binFileName": {
    "description": "Location of BIN files to be loaded from disk",
    "type": "string",
    "required": false
  },
  "corsAllowedOrigins": {
    "description": "Sets the origins allowed to submit requests to triPOS",
    "type": "string",
    "required": false
  },
  "pinPadIdleMessage": {
    "description": "Message to display on the PIN pad when it is idle.",
    "type": "string",
    "required": false
  },
  "testMode": {
    "description": "Set to 'true' to be in Test/Certification mode or 'false' for Production mode.",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
PUT
/api/v1/configuration/application Update application settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
UpdateApplicationConfigurationRequest body PUT_UpdateApplicationConfigurationRequest/v1/configuration/application undefined

Request Class

UpdateApplicationConfigurationRequest 
{
  "pinPadIdleMessage": "string",
  "testMode": "string",
  "binFileName": "string",
  "corsAllowedOrigins": "string"
}
UpdateApplicationConfigurationRequest
Field Required Data Type Description
pinPadIdleMessage true string Message to display on the PIN pad when it is idle.
testMode true string Set to 'true' to be in Test/Certification mode or 'false' for Production mode.
binFileName false string Location of BIN files to be loaded from disk
corsAllowedOrigins false string Sets the origins allowed to submit requests to triPOS using a comma separated string and HTTP prefix (Example: http://www.elementps.com, http://www.vantiv.com). To disable CORS support set the corsAllowedOrigins to an emptry string. To enable CORS for all domains set corsAllowOrigins to '*'.
UpdateApplicationConfigurationRequest 
{
  "pinPadIdleMessage": {
    "description": "Message to display on the PIN pad when it is idle.",
    "type": "string",
    "required": true
  },
  "testMode": {
    "description": "Set to 'true' to be in Test/Certification mode or 'false' for Production mode.",
    "type": "string",
    "required": true
  },
  "binFileName": {
    "description": "Location of BIN files to be loaded from disk",
    "type": "string",
    "required": false
  },
  "corsAllowedOrigins": {
    "description": "Sets the origins allowed to submit requests to triPOS using a comma separated string and HTTP prefix (Example: http://www.elementps.com, http://www.vantiv.com). To disable CORS support set the corsAllowedOrigins to an emptry string. To enable CORS for all domains set corsAllowOrigins to '*'.",
    "type": "string",
    "required": false
  }
}

Response Class

UpdateApplicationConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "applicationUpdated": "boolean",
  "binFileName": "string",
  "corsAllowedOrigins": "string",
  "pinPadIdleMessage": "string",
  "testMode": "string"
}
UpdateApplicationConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
applicationUpdated false boolean Success message for application settings update.
binFileName false string Location of BIN files to be loaded from disk
corsAllowedOrigins false string Sets the origins allowed to submit requests to triPOS
pinPadIdleMessage false string Message to display on the PIN pad when it is idle.
testMode false string Set to 'true' to be in Test/Certification mode or 'false' for Production mode.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
UpdateApplicationConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "applicationUpdated": {
    "description": "Success message for application settings update.",
    "type": "boolean",
    "required": false
  },
  "binFileName": {
    "description": "Location of BIN files to be loaded from disk",
    "type": "string",
    "required": false
  },
  "corsAllowedOrigins": {
    "description": "Sets the origins allowed to submit requests to triPOS",
    "type": "string",
    "required": false
  },
  "pinPadIdleMessage": {
    "description": "Message to display on the PIN pad when it is idle.",
    "type": "string",
    "required": false
  },
  "testMode": {
    "description": "Set to 'true' to be in Test/Certification mode or 'false' for Production mode.",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/configuration/host Get host settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetHostConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "autoReversalRetryLimit": "int",
  "driver": "string"
}
GetHostConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
autoReversalRetryLimit false int The number of times to automatically retry a reversal after a system failure
driver false string Driver value of Host settings
Values:
  • Null
  • Express
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
GetHostConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "autoReversalRetryLimit": {
    "description": "The number of times to automatically retry a reversal after a system failure",
    "type": "int",
    "required": false
  },
  "driver": {
    "description": "Driver value of Host settings",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "Express"
      ]
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
PUT
/api/v1/configuration/host Update host settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
UpdateHostConfigurationRequest body PUT_UpdateHostConfigurationRequest/v1/configuration/host undefined

Request Class

UpdateHostConfigurationRequest 
{
  "autoReversalRetryLimit": "int",
  "driver": "string"
}
UpdateHostConfigurationRequest
Field Required Data Type Description
autoReversalRetryLimit true int The number of times to automatically retry a reversal after a failed interaction with the host. This must be a value between 1-4 (Default=1)
driver true string Set to either 'Express' or 'Null'. Use Null to test without any connection to express.
Values:
  • Null
  • Express
UpdateHostConfigurationRequest 
{
  "autoReversalRetryLimit": {
    "description": "The number of times to automatically retry a reversal after a failed interaction with the host. This must be a value between 1-4 (Default=1)",
    "type": "int",
    "required": true
  },
  "driver": {
    "description": "Set to either 'Express' or 'Null'. Use Null to test without any connection to express.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "Express"
      ]
    },
    "required": true
  }
}

Response Class

UpdateHostConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "autoReversalRetryLimit": "int",
  "driver": "string",
  "hostUpdated": "boolean"
}
UpdateHostConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
autoReversalRetryLimit false int The number of times to automatically retry a reversal after a failure
driver false string Set to either 'Express' or 'Null'. Use Null to test without any connection to express.
Values:
  • Null
  • Express
hostUpdated false boolean Success value for updating host settings.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
UpdateHostConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "autoReversalRetryLimit": {
    "description": "The number of times to automatically retry a reversal after a failure",
    "type": "int",
    "required": false
  },
  "driver": {
    "description": "Set to either 'Express' or 'Null'. Use Null to test without any connection to express.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "Express"
      ]
    },
    "required": false
  },
  "hostUpdated": {
    "description": "Success value for updating host settings.",
    "type": "boolean",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/configuration/lanes Retrieve all lanes settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetLanesConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "ipLanes": {
    "_errors": "Array<ApiError>",
    "_hasErrors": "boolean",
    "_links": "Array<ApiLink>",
    "_logs": "Array<string>",
    "_type": "string",
    "_warnings": "Array<ApiWarning>",
    "description": "string",
    "driver": "string",
    "idleScreenImage": "string",
    "idleScreenMessage": "string",
    "ip": {
      "address": "string",
      "port": "string"
    },
    "isContactlessMsdEntryAllowed": "string",
    "isManualEntryAllowed": "string",
    "laneId": "int",
    "store": {
      "transactionAmountLimit": "int"
    },
    "terminalId": "string",
    "terminalType": "string"
  },
  "serialLanes": {
    "_errors": "Array<ApiError>",
    "_hasErrors": "boolean",
    "_links": "Array<ApiLink>",
    "_logs": "Array<string>",
    "_type": "string",
    "_warnings": "Array<ApiWarning>",
    "description": "string",
    "driver": "string",
    "idleScreenImage": "string",
    "idleScreenMessage": "string",
    "isContactlessMsdEntryAllowed": "string",
    "isManualEntryAllowed": "string",
    "laneId": "int",
    "serial": {
      "baudRate": "string",
      "comPort": "string",
      "dataBits": "string",
      "handshake": "string",
      "parity": "string",
      "stopBits": "string"
    },
    "store": "LaneStore",
    "terminalId": "string",
    "terminalType": "string"
  }
}
GetLanesConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ipLanes false Array<IpLane> List of IP lanes.
serialLanes false Array<SerialLane> List of serial lanes.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
IpLane
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
ip false Ip IP device properties.
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
Ip
Field Required Data Type Description
address true string IP address of PIN pad if not connected via serial device.
port false string IP port of PIN pad if not connected via serial device.
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
SerialLane
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
serial false Serial Serial device properties.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
Serial
Field Required Data Type Description
baudRate true string Baud rate of serial communications.
Values:
  • 75
  • 110
  • 300
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
comPort true string Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).
dataBits true string If the PIN pad is connected via serial device, the data bit setting.
handshake true string If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.
Values:
  • None
  • XonXoff
  • RequestToSend
parity true string If the PIN pad is connected via serial device, the parity setting.
stopBits true string If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.
Values:
  • None
  • One
  • OnePointFive
  • Two
GetLanesConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "ipLanes": {
    "description": "List of IP lanes.",
    "type": "Array",
    "items": {
      "$ref": "IpLane"
    },
    "required": false
  },
  "serialLanes": {
    "description": "List of serial lanes.",
    "type": "Array",
    "items": {
      "$ref": "SerialLane"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
IpLane 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "ip": {
    "description": "IP device properties.",
    "type": "Ip",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
Ip 
{
  "address": {
    "description": "IP address of PIN pad if not connected via serial device.",
    "type": "string",
    "required": true
  },
  "port": {
    "description": "IP port of PIN pad if not connected via serial device.",
    "type": "string",
    "required": false
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
SerialLane 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "serial": {
    "description": "Serial device properties.",
    "type": "Serial",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
Serial 
{
  "baudRate": {
    "description": "Baud rate of serial communications.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "75",
        "110",
        "300",
        "1200",
        "2400",
        "4800",
        "9600",
        "19200",
        "38400",
        "57600",
        "115200"
      ]
    },
    "required": true
  },
  "comPort": {
    "description": "Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).",
    "type": "string",
    "required": true
  },
  "dataBits": {
    "description": "If the PIN pad is connected via serial device, the data bit setting.",
    "type": "string",
    "required": true
  },
  "handshake": {
    "description": "If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "XonXoff",
        "RequestToSend"
      ]
    },
    "required": true
  },
  "parity": {
    "description": "If the PIN pad is connected via serial device, the parity setting.",
    "type": "string",
    "required": true
  },
  "stopBits": {
    "description": "If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.  ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "One",
        "OnePointFive",
        "Two"
      ]
    },
    "required": true
  }
}
GET
/api/v1/configuration/lanes/ip Retrieve all IP lane settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetIpLanesConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "ipLanes": {
    "_errors": "Array<ApiError>",
    "_hasErrors": "boolean",
    "_links": "Array<ApiLink>",
    "_logs": "Array<string>",
    "_type": "string",
    "_warnings": "Array<ApiWarning>",
    "description": "string",
    "driver": "string",
    "idleScreenImage": "string",
    "idleScreenMessage": "string",
    "ip": {
      "address": "string",
      "port": "string"
    },
    "isContactlessMsdEntryAllowed": "string",
    "isManualEntryAllowed": "string",
    "laneId": "int",
    "store": {
      "transactionAmountLimit": "int"
    },
    "terminalId": "string",
    "terminalType": "string"
  },
  "serialLanes": {
    "_errors": "Array<ApiError>",
    "_hasErrors": "boolean",
    "_links": "Array<ApiLink>",
    "_logs": "Array<string>",
    "_type": "string",
    "_warnings": "Array<ApiWarning>",
    "description": "string",
    "driver": "string",
    "idleScreenImage": "string",
    "idleScreenMessage": "string",
    "isContactlessMsdEntryAllowed": "string",
    "isManualEntryAllowed": "string",
    "laneId": "int",
    "serial": {
      "baudRate": "string",
      "comPort": "string",
      "dataBits": "string",
      "handshake": "string",
      "parity": "string",
      "stopBits": "string"
    },
    "store": "LaneStore",
    "terminalId": "string",
    "terminalType": "string"
  }
}
GetIpLanesConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ipLanes false Array<IpLane> List of IP lanes.
serialLanes false Array<SerialLane> List of serial lanes.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
IpLane
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
ip false Ip IP device properties.
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
Ip
Field Required Data Type Description
address true string IP address of PIN pad if not connected via serial device.
port false string IP port of PIN pad if not connected via serial device.
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
SerialLane
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
serial false Serial Serial device properties.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
Serial
Field Required Data Type Description
baudRate true string Baud rate of serial communications.
Values:
  • 75
  • 110
  • 300
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
comPort true string Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).
dataBits true string If the PIN pad is connected via serial device, the data bit setting.
handshake true string If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.
Values:
  • None
  • XonXoff
  • RequestToSend
parity true string If the PIN pad is connected via serial device, the parity setting.
stopBits true string If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.
Values:
  • None
  • One
  • OnePointFive
  • Two
GetIpLanesConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "ipLanes": {
    "description": "List of IP lanes.",
    "type": "Array",
    "items": {
      "$ref": "IpLane"
    },
    "required": false
  },
  "serialLanes": {
    "description": "List of serial lanes.",
    "type": "Array",
    "items": {
      "$ref": "SerialLane"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
IpLane 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "ip": {
    "description": "IP device properties.",
    "type": "Ip",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
Ip 
{
  "address": {
    "description": "IP address of PIN pad if not connected via serial device.",
    "type": "string",
    "required": true
  },
  "port": {
    "description": "IP port of PIN pad if not connected via serial device.",
    "type": "string",
    "required": false
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
SerialLane 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "serial": {
    "description": "Serial device properties.",
    "type": "Serial",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
Serial 
{
  "baudRate": {
    "description": "Baud rate of serial communications.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "75",
        "110",
        "300",
        "1200",
        "2400",
        "4800",
        "9600",
        "19200",
        "38400",
        "57600",
        "115200"
      ]
    },
    "required": true
  },
  "comPort": {
    "description": "Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).",
    "type": "string",
    "required": true
  },
  "dataBits": {
    "description": "If the PIN pad is connected via serial device, the data bit setting.",
    "type": "string",
    "required": true
  },
  "handshake": {
    "description": "If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "XonXoff",
        "RequestToSend"
      ]
    },
    "required": true
  },
  "parity": {
    "description": "If the PIN pad is connected via serial device, the parity setting.",
    "type": "string",
    "required": true
  },
  "stopBits": {
    "description": "If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.  ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "One",
        "OnePointFive",
        "Two"
      ]
    },
    "required": true
  }
}
POST
/api/v1/configuration/lanes/ip Creates lane settings with options for IP Address and IP Port

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
CreateIpLaneRequest body POST_CreateIpLaneRequest/v1/configuration/lanes/ip undefined

Request Class

CreateIpLaneRequest 
{
  "driver": "string",
  "ip": {
    "address": "string",
    "port": "string"
  },
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneId": "int",
  "terminalId": "string",
  "terminalType": "string",
  "description": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "store": {
    "transactionAmountLimit": "int"
  }
}
CreateIpLaneRequest
Field Required Data Type Description
driver true string PIN pad driver type
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
ip true POST_Ip/v1/configuration/lanes/ip Collection of IP device properties.
isContactlessMsdEntryAllowed true string Set to true to allow contactless entry.
isManualEntryAllowed true string Set to true to allow manual entry of card account numbers on the PIN pad.
laneId true int The desired lane ID. The lane ID should be a maximum of six digits long.
terminalId true string The Terminal ID to be passed to host.
terminalType true string The terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
description false string Description of lane.
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
store false POST_LaneStore/v1/configuration/lanes/ip store
Ip
Field Required Data Type Description
address true string IP address of PIN pad if not connected via serial device.
port false string IP port of PIN pad if not connected via serial device.
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
CreateIpLaneRequest 
{
  "driver": {
    "description": "PIN pad driver type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": true
  },
  "ip": {
    "description": "Collection of IP device properties.",
    "type": "POST_Ip/v1/configuration/lanes/ip",
    "required": true
  },
  "isContactlessMsdEntryAllowed": {
    "description": "Set to true to allow contactless entry.",
    "type": "string",
    "required": true
  },
  "isManualEntryAllowed": {
    "description": "Set to true to allow manual entry of card account numbers on the PIN pad.",
    "type": "string",
    "required": true
  },
  "laneId": {
    "description": "The desired lane ID. The lane ID should be a maximum of six digits long.",
    "type": "int",
    "allowableValues": {},
    "required": true
  },
  "terminalId": {
    "description": "The Terminal ID to be passed to host.",
    "type": "string",
    "required": true
  },
  "terminalType": {
    "description": "The terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": true
  },
  "description": {
    "description": "Description of lane.",
    "type": "string",
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "allowableValues": {},
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "allowableValues": {},
    "required": false
  },
  "store": {
    "description": "store",
    "type": "POST_LaneStore/v1/configuration/lanes/ip",
    "required": false
  }
}
Ip 
{
  "address": {
    "description": "IP address of PIN pad if not connected via serial device.",
    "type": "string",
    "required": true
  },
  "port": {
    "description": "IP port of PIN pad if not connected via serial device.",
    "type": "string",
    "required": false
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}

Response Class

CreateIpLaneResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "description": "string",
  "driver": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "ip": {
    "address": "string",
    "port": "string"
  },
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneCreated": "boolean",
  "laneId": "int",
  "store": {
    "transactionAmountLimit": "int"
  },
  "terminalId": "string",
  "terminalType": "string"
}
CreateIpLaneResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
ip false Ip IP device properties.
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneCreated false boolean True if lane was created successfully and false otherwise.
laneId false int Lane ID for lane setting.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Ip
Field Required Data Type Description
address true string IP address of PIN pad if not connected via serial device.
port false string IP port of PIN pad if not connected via serial device.
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
CreateIpLaneResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "ip": {
    "description": "IP device properties.",
    "type": "Ip",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneCreated": {
    "description": "True if lane was created successfully and false otherwise.",
    "type": "boolean",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Ip 
{
  "address": {
    "description": "IP address of PIN pad if not connected via serial device.",
    "type": "string",
    "required": true
  },
  "port": {
    "description": "IP port of PIN pad if not connected via serial device.",
    "type": "string",
    "required": false
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
DELETE
/api/v1/configuration/lanes/ip/{laneId} Delete ip lanes settings for lane with laneId

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
DeleteLaneRequest body DELETE_DeleteLaneRequest/v1/configuration/lanes/ip/{laneId} undefined

Request Class

DeleteLaneRequest 
{}
DeleteLaneRequest
Field Required Data Type Description
DeleteLaneRequest 
{}

Response Class

DeleteLaneResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "laneDeleted": "boolean"
}
DeleteLaneResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
laneDeleted false boolean True if lane was deleted false otherwise.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
DeleteLaneResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "laneDeleted": {
    "description": "True if lane was deleted false otherwise.",
    "type": "boolean",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if the type of lane being deleted does not match the type of lane in the request URL (i.e. deleting a serial lane from the /v1/configuration/lanes/ip/{laneId} endpoint).
GET
/api/v1/configuration/lanes/ip/{laneId} Retrieve specific IP lane settings

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetIpLaneResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "description": "string",
  "driver": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "ip": {
    "address": "string",
    "port": "string"
  },
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneId": "int",
  "store": {
    "transactionAmountLimit": "int"
  },
  "terminalId": "string",
  "terminalType": "string"
}
GetIpLaneResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
ip false Ip IP device properties.
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Ip
Field Required Data Type Description
address true string IP address of PIN pad if not connected via serial device.
port false string IP port of PIN pad if not connected via serial device.
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
GetIpLaneResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "ip": {
    "description": "IP device properties.",
    "type": "Ip",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Ip 
{
  "address": {
    "description": "IP address of PIN pad if not connected via serial device.",
    "type": "string",
    "required": true
  },
  "port": {
    "description": "IP port of PIN pad if not connected via serial device.",
    "type": "string",
    "required": false
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
PUT
/api/v1/configuration/lanes/ip/{laneId} Updates IP lanes settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
UpdateIpLaneRequest body PUT_UpdateIpLaneRequest/v1/configuration/lanes/ip/{laneId} undefined

Request Class

UpdateIpLaneRequest 
{
  "driver": "string",
  "ip": {
    "address": "string",
    "port": "string"
  },
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneId": "int",
  "terminalId": "string",
  "terminalType": "string",
  "description": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "store": {
    "transactionAmountLimit": "int"
  }
}
UpdateIpLaneRequest
Field Required Data Type Description
driver true string PIN pad driver type
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
ip true PUT_Ip/v1/configuration/lanes/ip/{laneId} Collection of IP device properties.
isContactlessMsdEntryAllowed true string Set to true to allow contactless entry.
isManualEntryAllowed true string Set to true to allow manual entry of card account numbers on the PIN pad.
laneId true int The desired lane ID. The lane ID should be a maximum of six digits long.
terminalId true string The Terminal ID to be passed to host.
terminalType true string The terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
description false string Description of lane.
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
store false PUT_LaneStore/v1/configuration/lanes/ip/{laneId} store
Ip
Field Required Data Type Description
address true string IP address of PIN pad if not connected via serial device.
port false string IP port of PIN pad if not connected via serial device.
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
UpdateIpLaneRequest 
{
  "driver": {
    "description": "PIN pad driver type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": true
  },
  "ip": {
    "description": "Collection of IP device properties.",
    "type": "PUT_Ip/v1/configuration/lanes/ip/{laneId}",
    "required": true
  },
  "isContactlessMsdEntryAllowed": {
    "description": "Set to true to allow contactless entry.",
    "type": "string",
    "required": true
  },
  "isManualEntryAllowed": {
    "description": "Set to true to allow manual entry of card account numbers on the PIN pad.",
    "type": "string",
    "required": true
  },
  "laneId": {
    "description": "The desired lane ID. The lane ID should be a maximum of six digits long.",
    "type": "int",
    "allowableValues": {},
    "required": true
  },
  "terminalId": {
    "description": "The Terminal ID to be passed to host.",
    "type": "string",
    "required": true
  },
  "terminalType": {
    "description": "The terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": true
  },
  "description": {
    "description": "Description of lane.",
    "type": "string",
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "allowableValues": {},
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "allowableValues": {},
    "required": false
  },
  "store": {
    "description": "store",
    "type": "PUT_LaneStore/v1/configuration/lanes/ip/{laneId}",
    "required": false
  }
}
Ip 
{
  "address": {
    "description": "IP address of PIN pad if not connected via serial device.",
    "type": "string",
    "required": true
  },
  "port": {
    "description": "IP port of PIN pad if not connected via serial device.",
    "type": "string",
    "required": false
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}

Response Class

UpdateIpLaneResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "description": "string",
  "driver": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "ip": {
    "address": "string",
    "port": "string"
  },
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneId": "int",
  "laneUpdated": "boolean",
  "store": {
    "transactionAmountLimit": "int"
  },
  "terminalId": "string",
  "terminalType": "string"
}
UpdateIpLaneResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
ip false Ip IP device properties.
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
laneUpdated false boolean True if lane was updated successfully and false otherwise.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Ip
Field Required Data Type Description
address true string IP address of PIN pad if not connected via serial device.
port false string IP port of PIN pad if not connected via serial device.
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
UpdateIpLaneResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "ip": {
    "description": "IP device properties.",
    "type": "Ip",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "laneUpdated": {
    "description": "True if lane was updated successfully and false otherwise.",
    "type": "boolean",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Ip 
{
  "address": {
    "description": "IP address of PIN pad if not connected via serial device.",
    "type": "string",
    "required": true
  },
  "port": {
    "description": "IP port of PIN pad if not connected via serial device.",
    "type": "string",
    "required": false
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
GET
/api/v1/configuration/lanes/serial Retrieve all serial lane settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetSerialLanesConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "ipLanes": {
    "_errors": "Array<ApiError>",
    "_hasErrors": "boolean",
    "_links": "Array<ApiLink>",
    "_logs": "Array<string>",
    "_type": "string",
    "_warnings": "Array<ApiWarning>",
    "description": "string",
    "driver": "string",
    "idleScreenImage": "string",
    "idleScreenMessage": "string",
    "ip": {
      "address": "string",
      "port": "string"
    },
    "isContactlessMsdEntryAllowed": "string",
    "isManualEntryAllowed": "string",
    "laneId": "int",
    "store": {
      "transactionAmountLimit": "int"
    },
    "terminalId": "string",
    "terminalType": "string"
  },
  "serialLanes": {
    "_errors": "Array<ApiError>",
    "_hasErrors": "boolean",
    "_links": "Array<ApiLink>",
    "_logs": "Array<string>",
    "_type": "string",
    "_warnings": "Array<ApiWarning>",
    "description": "string",
    "driver": "string",
    "idleScreenImage": "string",
    "idleScreenMessage": "string",
    "isContactlessMsdEntryAllowed": "string",
    "isManualEntryAllowed": "string",
    "laneId": "int",
    "serial": {
      "baudRate": "string",
      "comPort": "string",
      "dataBits": "string",
      "handshake": "string",
      "parity": "string",
      "stopBits": "string"
    },
    "store": "LaneStore",
    "terminalId": "string",
    "terminalType": "string"
  }
}
GetSerialLanesConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ipLanes false Array<IpLane> List of IP lanes.
serialLanes false Array<SerialLane> List of serial lanes.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
IpLane
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
ip false Ip IP device properties.
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
Ip
Field Required Data Type Description
address true string IP address of PIN pad if not connected via serial device.
port false string IP port of PIN pad if not connected via serial device.
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
SerialLane
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
serial false Serial Serial device properties.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
Serial
Field Required Data Type Description
baudRate true string Baud rate of serial communications.
Values:
  • 75
  • 110
  • 300
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
comPort true string Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).
dataBits true string If the PIN pad is connected via serial device, the data bit setting.
handshake true string If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.
Values:
  • None
  • XonXoff
  • RequestToSend
parity true string If the PIN pad is connected via serial device, the parity setting.
stopBits true string If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.
Values:
  • None
  • One
  • OnePointFive
  • Two
GetSerialLanesConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "ipLanes": {
    "description": "List of IP lanes.",
    "type": "Array",
    "items": {
      "$ref": "IpLane"
    },
    "required": false
  },
  "serialLanes": {
    "description": "List of serial lanes.",
    "type": "Array",
    "items": {
      "$ref": "SerialLane"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
IpLane 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "ip": {
    "description": "IP device properties.",
    "type": "Ip",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
Ip 
{
  "address": {
    "description": "IP address of PIN pad if not connected via serial device.",
    "type": "string",
    "required": true
  },
  "port": {
    "description": "IP port of PIN pad if not connected via serial device.",
    "type": "string",
    "required": false
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
SerialLane 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "serial": {
    "description": "Serial device properties.",
    "type": "Serial",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
Serial 
{
  "baudRate": {
    "description": "Baud rate of serial communications.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "75",
        "110",
        "300",
        "1200",
        "2400",
        "4800",
        "9600",
        "19200",
        "38400",
        "57600",
        "115200"
      ]
    },
    "required": true
  },
  "comPort": {
    "description": "Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).",
    "type": "string",
    "required": true
  },
  "dataBits": {
    "description": "If the PIN pad is connected via serial device, the data bit setting.",
    "type": "string",
    "required": true
  },
  "handshake": {
    "description": "If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "XonXoff",
        "RequestToSend"
      ]
    },
    "required": true
  },
  "parity": {
    "description": "If the PIN pad is connected via serial device, the parity setting.",
    "type": "string",
    "required": true
  },
  "stopBits": {
    "description": "If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.  ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "One",
        "OnePointFive",
        "Two"
      ]
    },
    "required": true
  }
}
POST
/api/v1/configuration/lanes/serial Creates lane settings with options for serial device

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
CreateSerialLaneRequest body POST_CreateSerialLaneRequest/v1/configuration/lanes/serial undefined

Request Class

CreateSerialLaneRequest 
{
  "driver": "string",
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneId": "int",
  "serial": {
    "baudRate": "string",
    "comPort": "string",
    "dataBits": "string",
    "handshake": "string",
    "parity": "string",
    "stopBits": "string"
  },
  "terminalId": "string",
  "terminalType": "string",
  "description": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "store": {
    "transactionAmountLimit": "int"
  }
}
CreateSerialLaneRequest
Field Required Data Type Description
driver true string PIN pad driver type
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
isContactlessMsdEntryAllowed true string Set to true to allow contactless entry.
isManualEntryAllowed true string Set to true to allow manual entry of card account numbers on the PIN pad.
laneId true int The desired lane ID. The lane ID should be a maximum of six digits long.
serial true POST_Serial/v1/configuration/lanes/serial Collection of Serial device properties
terminalId true string The Terminal ID to be passed to host.
terminalType true string The terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
description false string Description of lane.
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
store false POST_LaneStore/v1/configuration/lanes/serial store
Serial
Field Required Data Type Description
baudRate true string Baud rate of serial communications.
Values:
  • 75
  • 110
  • 300
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
comPort true string Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).
dataBits true string If the PIN pad is connected via serial device, the data bit setting.
handshake true string If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.
Values:
  • None
  • XonXoff
  • RequestToSend
parity true string If the PIN pad is connected via serial device, the parity setting.
stopBits true string If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.
Values:
  • None
  • One
  • OnePointFive
  • Two
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
CreateSerialLaneRequest 
{
  "driver": {
    "description": "PIN pad driver type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": true
  },
  "isContactlessMsdEntryAllowed": {
    "description": "Set to true to allow contactless entry.",
    "type": "string",
    "required": true
  },
  "isManualEntryAllowed": {
    "description": "Set to true to allow manual entry of card account numbers on the PIN pad.",
    "type": "string",
    "required": true
  },
  "laneId": {
    "description": "The desired lane ID. The lane ID should be a maximum of six digits long.",
    "type": "int",
    "allowableValues": {},
    "required": true
  },
  "serial": {
    "description": "Collection of Serial device properties",
    "type": "POST_Serial/v1/configuration/lanes/serial",
    "required": true
  },
  "terminalId": {
    "description": "The Terminal ID to be passed to host.",
    "type": "string",
    "required": true
  },
  "terminalType": {
    "description": "The terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": true
  },
  "description": {
    "description": "Description of lane.",
    "type": "string",
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "allowableValues": {},
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "allowableValues": {},
    "required": false
  },
  "store": {
    "description": "store",
    "type": "POST_LaneStore/v1/configuration/lanes/serial",
    "required": false
  }
}
Serial 
{
  "baudRate": {
    "description": "Baud rate of serial communications.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "75",
        "110",
        "300",
        "1200",
        "2400",
        "4800",
        "9600",
        "19200",
        "38400",
        "57600",
        "115200"
      ]
    },
    "required": true
  },
  "comPort": {
    "description": "Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).",
    "type": "string",
    "required": true
  },
  "dataBits": {
    "description": "If the PIN pad is connected via serial device, the data bit setting.",
    "type": "string",
    "required": true
  },
  "handshake": {
    "description": "If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "XonXoff",
        "RequestToSend"
      ]
    },
    "required": true
  },
  "parity": {
    "description": "If the PIN pad is connected via serial device, the parity setting.",
    "type": "string",
    "required": true
  },
  "stopBits": {
    "description": "If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.  ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "One",
        "OnePointFive",
        "Two"
      ]
    },
    "required": true
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}

Response Class

CreateSerialLaneResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "description": "string",
  "driver": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneCreated": "boolean",
  "laneId": "int",
  "serial": {
    "baudRate": "string",
    "comPort": "string",
    "dataBits": "string",
    "handshake": "string",
    "parity": "string",
    "stopBits": "string"
  },
  "store": {
    "transactionAmountLimit": "int"
  },
  "terminalId": "string",
  "terminalType": "string"
}
CreateSerialLaneResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneCreated false boolean True if lane was created successfully and false otherwise.
laneId false int Lane ID for lane setting.
serial false Serial Serial device properties.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Serial
Field Required Data Type Description
baudRate true string Baud rate of serial communications.
Values:
  • 75
  • 110
  • 300
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
comPort true string Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).
dataBits true string If the PIN pad is connected via serial device, the data bit setting.
handshake true string If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.
Values:
  • None
  • XonXoff
  • RequestToSend
parity true string If the PIN pad is connected via serial device, the parity setting.
stopBits true string If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.
Values:
  • None
  • One
  • OnePointFive
  • Two
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
CreateSerialLaneResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneCreated": {
    "description": "True if lane was created successfully and false otherwise.",
    "type": "boolean",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "serial": {
    "description": "Serial device properties.",
    "type": "Serial",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Serial 
{
  "baudRate": {
    "description": "Baud rate of serial communications.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "75",
        "110",
        "300",
        "1200",
        "2400",
        "4800",
        "9600",
        "19200",
        "38400",
        "57600",
        "115200"
      ]
    },
    "required": true
  },
  "comPort": {
    "description": "Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).",
    "type": "string",
    "required": true
  },
  "dataBits": {
    "description": "If the PIN pad is connected via serial device, the data bit setting.",
    "type": "string",
    "required": true
  },
  "handshake": {
    "description": "If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "XonXoff",
        "RequestToSend"
      ]
    },
    "required": true
  },
  "parity": {
    "description": "If the PIN pad is connected via serial device, the parity setting.",
    "type": "string",
    "required": true
  },
  "stopBits": {
    "description": "If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.  ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "One",
        "OnePointFive",
        "Two"
      ]
    },
    "required": true
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
DELETE
/api/v1/configuration/lanes/serial/{laneId} Delete serial lanes settings for lane with laneId

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
DeleteLaneRequest body DELETE_DeleteLaneRequest/v1/configuration/lanes/serial/{laneId} undefined

Request Class

DeleteLaneRequest 
{}
DeleteLaneRequest
Field Required Data Type Description
DeleteLaneRequest 
{}

Response Class

DeleteLaneResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "laneDeleted": "boolean"
}
DeleteLaneResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
laneDeleted false boolean True if lane was deleted false otherwise.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
DeleteLaneResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "laneDeleted": {
    "description": "True if lane was deleted false otherwise.",
    "type": "boolean",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if the type of lane being deleted does not match the type of lane in the request URL (i.e. deleting a serial lane from the /v1/configuration/lanes/ip/{laneId} endpoint).
GET
/api/v1/configuration/lanes/serial/{laneId} Retrieve specific serial lane settings

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetSerialLaneResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "description": "string",
  "driver": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneId": "int",
  "serial": {
    "baudRate": "string",
    "comPort": "string",
    "dataBits": "string",
    "handshake": "string",
    "parity": "string",
    "stopBits": "string"
  },
  "store": {
    "transactionAmountLimit": "int"
  },
  "terminalId": "string",
  "terminalType": "string"
}
GetSerialLaneResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
serial false Serial Serial device properties.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Serial
Field Required Data Type Description
baudRate true string Baud rate of serial communications.
Values:
  • 75
  • 110
  • 300
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
comPort true string Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).
dataBits true string If the PIN pad is connected via serial device, the data bit setting.
handshake true string If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.
Values:
  • None
  • XonXoff
  • RequestToSend
parity true string If the PIN pad is connected via serial device, the parity setting.
stopBits true string If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.
Values:
  • None
  • One
  • OnePointFive
  • Two
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
GetSerialLaneResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "serial": {
    "description": "Serial device properties.",
    "type": "Serial",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Serial 
{
  "baudRate": {
    "description": "Baud rate of serial communications.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "75",
        "110",
        "300",
        "1200",
        "2400",
        "4800",
        "9600",
        "19200",
        "38400",
        "57600",
        "115200"
      ]
    },
    "required": true
  },
  "comPort": {
    "description": "Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).",
    "type": "string",
    "required": true
  },
  "dataBits": {
    "description": "If the PIN pad is connected via serial device, the data bit setting.",
    "type": "string",
    "required": true
  },
  "handshake": {
    "description": "If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "XonXoff",
        "RequestToSend"
      ]
    },
    "required": true
  },
  "parity": {
    "description": "If the PIN pad is connected via serial device, the parity setting.",
    "type": "string",
    "required": true
  },
  "stopBits": {
    "description": "If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.  ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "One",
        "OnePointFive",
        "Two"
      ]
    },
    "required": true
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
PUT
/api/v1/configuration/lanes/serial/{laneId} Updates serial lanes settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
UpdateSerialLaneRequest body PUT_UpdateSerialLaneRequest/v1/configuration/lanes/serial/{laneId} undefined

Request Class

UpdateSerialLaneRequest 
{
  "driver": "string",
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneId": "int",
  "serial": {
    "baudRate": "string",
    "comPort": "string",
    "dataBits": "string",
    "handshake": "string",
    "parity": "string",
    "stopBits": "string"
  },
  "terminalId": "string",
  "terminalType": "string",
  "description": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "store": {
    "transactionAmountLimit": "int"
  }
}
UpdateSerialLaneRequest
Field Required Data Type Description
driver true string PIN pad driver type
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
isContactlessMsdEntryAllowed true string Set to true to allow contactless entry.
isManualEntryAllowed true string Set to true to allow manual entry of card account numbers on the PIN pad.
laneId true int The desired lane ID. The lane ID should be a maximum of six digits long.
serial true PUT_Serial/v1/configuration/lanes/serial/{laneId} Collection of Serial device properties
terminalId true string The Terminal ID to be passed to host.
terminalType true string The terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
description false string Description of lane.
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
store false PUT_LaneStore/v1/configuration/lanes/serial/{laneId} store
Serial
Field Required Data Type Description
baudRate true string Baud rate of serial communications.
Values:
  • 75
  • 110
  • 300
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
comPort true string Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).
dataBits true string If the PIN pad is connected via serial device, the data bit setting.
handshake true string If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.
Values:
  • None
  • XonXoff
  • RequestToSend
parity true string If the PIN pad is connected via serial device, the parity setting.
stopBits true string If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.
Values:
  • None
  • One
  • OnePointFive
  • Two
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
UpdateSerialLaneRequest 
{
  "driver": {
    "description": "PIN pad driver type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": true
  },
  "isContactlessMsdEntryAllowed": {
    "description": "Set to true to allow contactless entry.",
    "type": "string",
    "required": true
  },
  "isManualEntryAllowed": {
    "description": "Set to true to allow manual entry of card account numbers on the PIN pad.",
    "type": "string",
    "required": true
  },
  "laneId": {
    "description": "The desired lane ID. The lane ID should be a maximum of six digits long.",
    "type": "int",
    "allowableValues": {},
    "required": true
  },
  "serial": {
    "description": "Collection of Serial device properties",
    "type": "PUT_Serial/v1/configuration/lanes/serial/{laneId}",
    "required": true
  },
  "terminalId": {
    "description": "The Terminal ID to be passed to host.",
    "type": "string",
    "required": true
  },
  "terminalType": {
    "description": "The terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": true
  },
  "description": {
    "description": "Description of lane.",
    "type": "string",
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "allowableValues": {},
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "allowableValues": {},
    "required": false
  },
  "store": {
    "description": "store",
    "type": "PUT_LaneStore/v1/configuration/lanes/serial/{laneId}",
    "required": false
  }
}
Serial 
{
  "baudRate": {
    "description": "Baud rate of serial communications.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "75",
        "110",
        "300",
        "1200",
        "2400",
        "4800",
        "9600",
        "19200",
        "38400",
        "57600",
        "115200"
      ]
    },
    "required": true
  },
  "comPort": {
    "description": "Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).",
    "type": "string",
    "required": true
  },
  "dataBits": {
    "description": "If the PIN pad is connected via serial device, the data bit setting.",
    "type": "string",
    "required": true
  },
  "handshake": {
    "description": "If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "XonXoff",
        "RequestToSend"
      ]
    },
    "required": true
  },
  "parity": {
    "description": "If the PIN pad is connected via serial device, the parity setting.",
    "type": "string",
    "required": true
  },
  "stopBits": {
    "description": "If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.  ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "One",
        "OnePointFive",
        "Two"
      ]
    },
    "required": true
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}

Response Class

UpdateSerialLaneResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "description": "string",
  "driver": "string",
  "idleScreenImage": "string",
  "idleScreenMessage": "string",
  "isContactlessMsdEntryAllowed": "string",
  "isManualEntryAllowed": "string",
  "laneId": "int",
  "laneUpdated": "boolean",
  "serial": {
    "baudRate": "string",
    "comPort": "string",
    "dataBits": "string",
    "handshake": "string",
    "parity": "string",
    "stopBits": "string"
  },
  "store": {
    "transactionAmountLimit": "int"
  },
  "terminalId": "string",
  "terminalType": "string"
}
UpdateSerialLaneResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
description false string Description for lane setting.
driver false string Driver value
Values:
  • Null
  • VeriFoneXpi
  • VeriFoneFormAgentXpi
  • Virtual
  • IngenicoRba
  • DebitNull
  • GiftNull
  • FinancialCardReadNull
  • NullPinPadDoesNotSupportSignature
  • NullPinPadReturnsContactlessMsd
  • NullPinPadReturnsEncryptedContactlessMsd
  • ConfigurableNull
  • Unknown
idleScreenImage false string The name of the image to display on the PIN pad when it is idle. more»
idleScreenMessage false string Message to display on the PIN pad when it is idle. more»
isContactlessMsdEntryAllowed false string If set to 'true' then contactless entry is allowed via the PIN pad.
isManualEntryAllowed false string If set to 'true' then manual entry of card account numbers on the PIN pad is allowed
laneId false int Lane ID for lane setting.
laneUpdated false boolean True if lane was updated successfully and false otherwise.
serial false Serial Serial device properties.
store false LaneStore Store setting for each lane.
terminalId false string Terminal ID of PIN pad.
terminalType false string terminal type
Values:
  • Unknown
  • PointOfSale
  • ECommerce
  • Moto
  • FuelPump
  • Atm
  • Voice
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Serial
Field Required Data Type Description
baudRate true string Baud rate of serial communications.
Values:
  • 75
  • 110
  • 300
  • 1200
  • 2400
  • 4800
  • 9600
  • 19200
  • 38400
  • 57600
  • 115200
comPort true string Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).
dataBits true string If the PIN pad is connected via serial device, the data bit setting.
handshake true string If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.
Values:
  • None
  • XonXoff
  • RequestToSend
parity true string If the PIN pad is connected via serial device, the parity setting.
stopBits true string If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.
Values:
  • None
  • One
  • OnePointFive
  • Two
LaneStore
Field Required Data Type Description
transactionAmountLimit true int When storing, triPOS will decline any transaction greater than this amount.
UpdateSerialLaneResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "description": {
    "description": "Description for lane setting.",
    "type": "string",
    "required": false
  },
  "driver": {
    "description": "Driver value",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Null",
        "VeriFoneXpi",
        "VeriFoneFormAgentXpi",
        "Virtual",
        "IngenicoRba",
        "DebitNull",
        "GiftNull",
        "FinancialCardReadNull",
        "NullPinPadDoesNotSupportSignature",
        "NullPinPadReturnsContactlessMsd",
        "NullPinPadReturnsEncryptedContactlessMsd",
        "ConfigurableNull",
        "Unknown"
      ]
    },
    "required": false
  },
  "idleScreenImage": {
    "description": "The name of the image to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "idleScreenMessage": {
    "description": "Message to display on the PIN pad when it is idle. <a href='../help/kb/idleScreen.html'>more&raquo;</a>",
    "type": "string",
    "required": false
  },
  "isContactlessMsdEntryAllowed": {
    "description": "If set to 'true' then contactless entry is allowed via the PIN pad.",
    "type": "string",
    "required": false
  },
  "isManualEntryAllowed": {
    "description": "If set to 'true' then manual entry of card account numbers on the PIN pad is allowed",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "Lane ID for lane setting.",
    "type": "int",
    "required": false
  },
  "laneUpdated": {
    "description": "True if lane was updated successfully and false otherwise.",
    "type": "boolean",
    "required": false
  },
  "serial": {
    "description": "Serial device properties.",
    "type": "Serial",
    "required": false
  },
  "store": {
    "description": "Store setting for each lane.",
    "type": "LaneStore",
    "required": false
  },
  "terminalId": {
    "description": "Terminal ID of PIN pad.",
    "type": "string",
    "required": false
  },
  "terminalType": {
    "description": "terminal type",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "PointOfSale",
        "ECommerce",
        "Moto",
        "FuelPump",
        "Atm",
        "Voice"
      ]
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Serial 
{
  "baudRate": {
    "description": "Baud rate of serial communications.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "75",
        "110",
        "300",
        "1200",
        "2400",
        "4800",
        "9600",
        "19200",
        "38400",
        "57600",
        "115200"
      ]
    },
    "required": true
  },
  "comPort": {
    "description": "Name of serial device to which the PIN pad is attached (e.g. COM1, /dev/tty1, etc).",
    "type": "string",
    "required": true
  },
  "dataBits": {
    "description": "If the PIN pad is connected via serial device, the data bit setting.",
    "type": "string",
    "required": true
  },
  "handshake": {
    "description": "If the PIN pad is connected via serial device, the handshake setting: 'None', 'RequestToSend', 'XonXoff'.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "XonXoff",
        "RequestToSend"
      ]
    },
    "required": true
  },
  "parity": {
    "description": "If the PIN pad is connected via serial device, the parity setting.",
    "type": "string",
    "required": true
  },
  "stopBits": {
    "description": "If the PIN pad is connected via serial device, the stop bits setting: None, One, OnePointFive, Two.  ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "One",
        "OnePointFive",
        "Two"
      ]
    },
    "required": true
  }
}
LaneStore 
{
  "transactionAmountLimit": {
    "description": "When storing, triPOS will decline any transaction greater than this amount.",
    "type": "int",
    "required": true
  }
}
GET
/api/v1/configuration/server Retrieve server settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetServerConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "clientPinPadListeningPort": "string",
  "listeningPort": "string",
  "useHttps": "string"
}
GetServerConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
clientPinPadListeningPort false string Listening port for incoming client pin pads.
listeningPort false string Listening port for service REST requests.
useHttps false string Set to true to use HTTPS for service REST requests. more»
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
GetServerConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "clientPinPadListeningPort": {
    "description": "Listening port for incoming client pin pads.",
    "type": "string",
    "required": false
  },
  "listeningPort": {
    "description": "Listening port for service REST requests.",
    "type": "string",
    "required": false
  },
  "useHttps": {
    "description": "Set to true to use HTTPS for service REST requests.  <a href='../help/kb/useHttps.html'>more»</a>",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
PUT
/api/v1/configuration/server Update server settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
UpdateServerConfigurationRequest body PUT_UpdateServerConfigurationRequest/v1/configuration/server undefined

Request Class

UpdateServerConfigurationRequest 
{
  "listeningPort": "string",
  "clientPinPadListeningPort": "string",
  "useHttps": "string"
}
UpdateServerConfigurationRequest
Field Required Data Type Description
listeningPort true string Listening port for service REST requests.
clientPinPadListeningPort false string Listening port for incoming client pin pads. Leave blank if your configuration does not include client pin pads.
useHttps false string Set to true to use HTTPS for service REST requests.
UpdateServerConfigurationRequest 
{
  "listeningPort": {
    "description": "Listening port for service REST requests.",
    "type": "string",
    "required": true
  },
  "clientPinPadListeningPort": {
    "description": "Listening port for incoming client pin pads. Leave blank if your configuration does not include client pin pads.",
    "type": "string",
    "required": false
  },
  "useHttps": {
    "description": "Set to true to use HTTPS for service REST requests.",
    "type": "string",
    "required": false
  }
}

Response Class

UpdateServerConfigurationResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "clientPinPadListeningPort": "string",
  "listeningPort": "string",
  "serverSettingsUpdated": "boolean",
  "useHttps": "string"
}
UpdateServerConfigurationResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
clientPinPadListeningPort false string Listening port for incoming client pin pads.
listeningPort false string Listening port for service REST requests.
serverSettingsUpdated false boolean Success value for updating server settings.
useHttps false string Set to true to use HTTPS for service REST requests. more»
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
UpdateServerConfigurationResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "clientPinPadListeningPort": {
    "description": "Listening port for incoming client pin pads.",
    "type": "string",
    "required": false
  },
  "listeningPort": {
    "description": "Listening port for service REST requests.",
    "type": "string",
    "required": false
  },
  "serverSettingsUpdated": {
    "description": "Success value for updating server settings.",
    "type": "boolean",
    "required": false
  },
  "useHttps": {
    "description": "Set to true to use HTTPS for service REST requests.  <a href='../help/kb/useHttps.html'>more»</a>",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/configuration/transaction Retrieve transaction settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetTransactionConfigurationResponse 
{
  "forward": {
    "forwardMode": "string"
  },
  "isEmvSupported": "boolean",
  "store": {
    "storeMode": "string",
    "unprocessedTotalAmountLimit": "int"
  },
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "allowPartialApprovals": "boolean",
  "cashBackIncrement": "string",
  "cashBackSelections": "string",
  "checkForDuplicateTransactions": "boolean",
  "confirmConvenienceFeeAmount": "boolean",
  "confirmOriginalAmount": "boolean",
  "creditAvsEntryCondition": "string",
  "creditSaleSignatureThresholdAmount": "double",
  "currencyCode": "string",
  "debitSurcharge": "double",
  "emvFallbackAllowed": "string",
  "isCashBackAllowed": "boolean",
  "isCscSupported": "boolean",
  "isDebitRefundSupported": "boolean",
  "isDebitSupported": "boolean",
  "isGiftSupported": "boolean",
  "isHealthcareSupported": "boolean",
  "isTipAllowed": "boolean",
  "marketCode": "string",
  "maximumCashbackAmount": "int",
  "signatureFormat": "string",
  "tipSelections": "string"
}
GetTransactionConfigurationResponse
Field Required Data Type Description
forward true TransactionForwardConfiguration Forward configuration to control the level of liability when using store and forward functions.
isEmvSupported true boolean Set to true to enable your application to accept EMV transactions. Set to false to not allow EMV transactions.
store true TransactionStoreConfiguration Store configuration to control the level of liability when using store and forward functions.
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
allowPartialApprovals false boolean If set to true, partial approvals are allowed.
cashBackIncrement false string Increments you want customers to be able to get back. Common values include, 1, 5, 10 and 20.
cashBackSelections false string Enter whole numbers separated by commas for the cashback amounts to select from.
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host. This can be overridden on a per request basis.
confirmConvenienceFeeAmount false boolean Set to true to require the PIN pad to display a confirmation message to the cardholder for the convenienceFeeAmount.
confirmOriginalAmount false boolean If set to true, the PIN Pad will prompt the cardholder to confirm the original amount.
creditAvsEntryCondition false string Set to true when AVS entry (billing postal code entry) should be prompted for credit transactions.
Values:
  • Always
  • Never
  • Keyed
creditSaleSignatureThresholdAmount false double Leave as 0 or empty to always require a signature for credit sale, otherwise set to the amount that must be surpassed before asking for a signature, such as 25.00
currencyCode false string The currency code that will be used for all transactions.
Values:
  • None
  • Usd
debitSurcharge false double Enter a decimal amount to add to debit transactions. Please read the credit / debit card surcharge statutes as they pertain to your state of business: 'http://www.ncsl.org/research/financial-services-and-commerce/credit-or-debit-card-surcharges-statutes.aspx'
emvFallbackAllowed false string Allow Emv Fallback.
Values:
  • NeverAllow
  • AllowAfterChipError
isCashBackAllowed false boolean Set to true to allow cashback.
isCscSupported false boolean If set to true triPOS will prompt for CVV during manual card entry.
isDebitRefundSupported false boolean Set to true to allow refunds onto a debit card. Not all processors support this.
isDebitSupported false boolean Set to true to allow debit only cards to be used. The credit functionality of check cards will still work if this is set to false.
isGiftSupported false boolean Set to true to allow gift only cards to be used. The credit functionality of check cards will still work if this is set to false.
isHealthcareSupported false boolean If set to true, Healthcare fields are allowed.
isTipAllowed false boolean Set to true to allow tips to be added.
marketCode false string The market code specific to the type of transaction being submitted. Can be overridden on a per request basis.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
maximumCashbackAmount false int The maximum cashback amount you want to allow cardholders to get back
signatureFormat false string The format which signature data should come back as.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
tipSelections false string Enter decimal numbers for tip amounts. Add percent sign after the number to display a percent option rather than a dollar amount (i.e. 10%, 15%, 20%). If any value is a percentage, it is assumed that all values are percentages. Add 'none' to show "None" on the pin pad, otherwise "Other" will always be shown on the pin pad.
TransactionForwardConfiguration
Field Required Data Type Description
forwardMode false string Allow triPOS to forward transactions automatically upon gaining connectivity, or merchant chooses to forward on per request basis.
Values:
  • PerRequest
  • Automatic
TransactionStoreConfiguration
Field Required Data Type Description
storeMode true string Allow triPOS to store transactions automatically upon losing connectivity, or merchant chooses to store on per request basis.
Values:
  • PerRequest
  • Automatic
unprocessedTotalAmountLimit false int When storing, triPOS will decline any transaction that causes the sum of all unprocessed transactions to exceed this maxiumum amount.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
GetTransactionConfigurationResponse 
{
  "forward": {
    "description": "Forward configuration to control the level of liability when using store and forward functions.",
    "type": "TransactionForwardConfiguration",
    "required": true
  },
  "isEmvSupported": {
    "description": "Set to true to enable your application to accept EMV transactions. Set to false to not allow EMV transactions.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "store": {
    "description": "Store configuration to control the level of liability when using store and forward functions.",
    "type": "TransactionStoreConfiguration",
    "required": true
  },
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed.",
    "type": "boolean",
    "required": false
  },
  "cashBackIncrement": {
    "description": "Increments you want customers to be able to get back. Common values include, 1, 5, 10 and 20.",
    "type": "string",
    "required": false
  },
  "cashBackSelections": {
    "description": "Enter whole numbers separated by commas for the cashback amounts to select from.",
    "type": "string",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host. This can be overridden on a per request basis.",
    "type": "boolean",
    "required": false
  },
  "confirmConvenienceFeeAmount": {
    "description": "Set to true to require the PIN pad to display a confirmation message to the cardholder for the convenienceFeeAmount.",
    "type": "boolean",
    "required": false
  },
  "confirmOriginalAmount": {
    "description": "If set to true, the PIN Pad will prompt the cardholder to confirm the original amount.",
    "type": "boolean",
    "required": false
  },
  "creditAvsEntryCondition": {
    "description": "Set to true when AVS entry (billing postal code entry) should be prompted for credit transactions.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "Keyed"
      ]
    },
    "required": false
  },
  "creditSaleSignatureThresholdAmount": {
    "description": "Leave as 0 or empty to always require a signature for credit sale, otherwise set to the amount that must be surpassed before asking for a signature, such as 25.00",
    "type": "double",
    "required": false
  },
  "currencyCode": {
    "description": "The currency code that will be used for all transactions.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": false
  },
  "debitSurcharge": {
    "description": "Enter a decimal amount to add to debit transactions. Please read the credit / debit card surcharge statutes as they pertain to your state of business: 'http://www.ncsl.org/research/financial-services-and-commerce/credit-or-debit-card-surcharges-statutes.aspx'",
    "type": "double",
    "required": false
  },
  "emvFallbackAllowed": {
    "description": "Allow Emv Fallback.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NeverAllow",
        "AllowAfterChipError"
      ]
    },
    "required": false
  },
  "isCashBackAllowed": {
    "description": "Set to true to allow cashback.",
    "type": "boolean",
    "required": false
  },
  "isCscSupported": {
    "description": "If set to true triPOS will prompt for CVV during manual card entry.",
    "type": "boolean",
    "required": false
  },
  "isDebitRefundSupported": {
    "description": "Set to true to allow refunds onto a debit card. Not all processors support this.",
    "type": "boolean",
    "required": false
  },
  "isDebitSupported": {
    "description": "Set to true to allow debit only cards to be used. The credit functionality of check cards will still work if this is set to false.",
    "type": "boolean",
    "required": false
  },
  "isGiftSupported": {
    "description": "Set to true to allow gift only cards to be used. The credit functionality of check cards will still work if this is set to false.",
    "type": "boolean",
    "required": false
  },
  "isHealthcareSupported": {
    "description": "If set to true, Healthcare fields are allowed.",
    "type": "boolean",
    "allowableValues": {},
    "required": false
  },
  "isTipAllowed": {
    "description": "Set to true to allow tips to be added.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code specific to the type of transaction being submitted. Can be overridden on a per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  },
  "maximumCashbackAmount": {
    "description": "The maximum cashback amount you want to allow cardholders to get back",
    "type": "int",
    "required": false
  },
  "signatureFormat": {
    "description": "The format which signature data should come back as.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "tipSelections": {
    "description": "Enter decimal numbers for tip amounts. Add percent sign after the number to display a percent option rather than a dollar amount (i.e. 10%, 15%, 20%). If any value is a percentage, it is assumed that all values are percentages. Add 'none' to show \"None\" on the pin pad, otherwise \"Other\" will always be shown on the pin pad.",
    "type": "string",
    "required": false
  }
}
TransactionForwardConfiguration 
{
  "forwardMode": {
    "description": "Allow triPOS to forward transactions automatically upon gaining connectivity, or merchant chooses to forward on per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PerRequest",
        "Automatic"
      ]
    },
    "required": false
  }
}
TransactionStoreConfiguration 
{
  "storeMode": {
    "description": "Allow triPOS to store transactions automatically upon losing connectivity, or merchant chooses to store on per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PerRequest",
        "Automatic"
      ]
    },
    "required": true
  },
  "unprocessedTotalAmountLimit": {
    "description": "When storing, triPOS will decline any transaction that causes the sum of all unprocessed transactions to exceed this maxiumum amount.",
    "type": "int",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
PUT
/api/v1/configuration/transaction Update transaction settings

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
UpdateTransactionConfigurationRequest body PUT_UpdateTransactionConfigurationRequest/v1/configuration/transaction undefined

Request Class

UpdateTransactionConfigurationRequest 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "confirmConvenienceFeeAmount": "boolean",
  "confirmOriginalAmount": "boolean",
  "creditAvsEntryCondition": "string",
  "creditSaleSignatureThresholdAmount": "double",
  "currencyCode": "string",
  "debitSurcharge": "double",
  "emvFallbackAllowed": "string",
  "forward": {
    "forwardMode": "string"
  },
  "isCashBackAllowed": "boolean",
  "isDebitSupported": "boolean",
  "isEmvSupported": "boolean",
  "isGiftSupported": "boolean",
  "isTipAllowed": "boolean",
  "marketCode": "string",
  "signatureFormat": "string",
  "store": {
    "storeMode": "string",
    "unprocessedTotalAmountLimit": "int"
  },
  "cashBackIncrement": "int",
  "cashbackSelections": "Array<int>",
  "decimalTipSelections": "Array<double>",
  "isCscSupported": "boolean",
  "isDebitRefundSupported": "boolean",
  "isHealthcareSupported": "boolean",
  "maximumCashbackAmount": "int",
  "noneTipSelection": "boolean",
  "otherCashbackSelection": "boolean",
  "percentTipSelections": "Array<double>"
}
UpdateTransactionConfigurationRequest
Field Required Data Type Description
allowPartialApprovals true boolean If set to true, partial approvals are allowed.
checkForDuplicateTransactions true boolean If set to true, enables duplicate checking logic for the transaction at the host. This can be overridden on a per request basis.
confirmConvenienceFeeAmount true boolean Set to true to require the PIN pad to display a confirmation message to the cardholder for the convenienceFeeAmount.
confirmOriginalAmount true boolean If set to true, the original transaction amount will be confirmed after card information is obtained.
creditAvsEntryCondition true string Set to true when AVS entry (billing postal code entry) should be prompted for credit transactions.
Values:
  • Always
  • Never
  • Keyed
creditSaleSignatureThresholdAmount true double Leave as 0 or empty to always require a signature for credit sale, otherwise set to the amount that must be surpassed before asking for a signature, such as 25.00
currencyCode true string The currency code that will be used for all transactions.
Values:
  • None
  • Usd
debitSurcharge true double Enter a decimal amount to add to debit transactions. Please read the credit / debit card surcharge statutes as they pertain to your state of business: 'http://www.ncsl.org/research/financial-services-and-commerce/credit-or-debit-card-surcharges-statutes.aspx'
emvFallbackAllowed true string Allow Emv Fallback.
Values:
  • NeverAllow
  • AllowAfterChipError
forward true PUT_TransactionForwardConfiguration/v1/configuration/transaction Forward configuration to control the level of liability when using store and forward functions.
isCashBackAllowed true boolean Set to true to allow cashback.
isDebitSupported true boolean Set to true to allow debit only cards to be used. The credit functionality of check cards will still work if this is set to false.
isEmvSupported true boolean Set to true to enable your application to accept EMV transactions. Set to false to not allow EMV transactions.
isGiftSupported true boolean Set to true to allow gift only cards to be used. The credit functionality of check cards will still work if this is set to false.
isTipAllowed true boolean Set to true to allow tips to be added.
marketCode true string The market code specific to the type of transaction being submitted. This global value can be set, but it can be overridden on a per request basis.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
signatureFormat true string The format which signature data should come back as.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
store true PUT_TransactionStoreConfiguration/v1/configuration/transaction Store configuration to control the level of liability when using store and forward functions.
cashBackIncrement false int Increments you want customers to be able to get back. Common values include, 1, 5, 10 and 20.
cashbackSelections false Array<int> Enter whole numbers separated by commas for the cashback amounts to select from.
decimalTipSelections false Array<double> Enter decimal numbers for tip amounts. If percent values were provided for tip amounts then these values will be ignored.
isCscSupported false boolean Set to true to prompt for CVV during manual card entry.
isDebitRefundSupported false boolean Set to true to allow refunds onto a debit card. Not all processors support this.
isHealthcareSupported false boolean If set to true, Healthcare fields are allowed.
maximumCashbackAmount false int The maximum cashback amount you want to allow cardholders to get back
noneTipSelection false boolean Enter true to show "None" on the PIN pad during tip selection. If false is entered "Other" will be shown instead.
otherCashbackSelection false boolean Enter true if you would like "Other" option to show up on cashback selection screen.
percentTipSelections false Array<double> Enter decimal numbers to be used as percent values for tip amounts. This means { 10, 15.5, 20.0 } will become the following tip selections (10%, 15.5%, 20%). If percent values are provided for tip amounts then decimal tip amounts will be ignored.
TransactionForwardConfiguration
Field Required Data Type Description
forwardMode false string Allow triPOS to forward transactions automatically upon gaining connectivity, or merchant chooses to forward on per request basis.
Values:
  • PerRequest
  • Automatic
TransactionStoreConfiguration
Field Required Data Type Description
storeMode true string Allow triPOS to store transactions automatically upon losing connectivity, or merchant chooses to store on per request basis.
Values:
  • PerRequest
  • Automatic
unprocessedTotalAmountLimit false int When storing, triPOS will decline any transaction that causes the sum of all unprocessed transactions to exceed this maxiumum amount.
UpdateTransactionConfigurationRequest 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host. This can be overridden on a per request basis.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "confirmConvenienceFeeAmount": {
    "description": "Set to true to require the PIN pad to display a confirmation message to the cardholder for the convenienceFeeAmount.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "confirmOriginalAmount": {
    "description": "If set to true, the original transaction amount will be confirmed after card information is obtained.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "creditAvsEntryCondition": {
    "description": "Set to true when AVS entry (billing postal code entry) should be prompted for credit transactions.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "Keyed"
      ]
    },
    "required": true
  },
  "creditSaleSignatureThresholdAmount": {
    "description": "Leave as 0 or empty to always require a signature for credit sale, otherwise set to the amount that must be surpassed before asking for a signature, such as 25.00",
    "type": "double",
    "allowableValues": {},
    "required": true
  },
  "currencyCode": {
    "description": "The currency code that will be used for all transactions.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": true
  },
  "debitSurcharge": {
    "description": "Enter a decimal amount to add to debit transactions. Please read the credit / debit card surcharge statutes as they pertain to your state of business: 'http://www.ncsl.org/research/financial-services-and-commerce/credit-or-debit-card-surcharges-statutes.aspx'",
    "type": "double",
    "allowableValues": {},
    "required": true
  },
  "emvFallbackAllowed": {
    "description": "Allow Emv Fallback.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NeverAllow",
        "AllowAfterChipError"
      ]
    },
    "required": true
  },
  "forward": {
    "description": "Forward configuration to control the level of liability when using store and forward functions.",
    "type": "PUT_TransactionForwardConfiguration/v1/configuration/transaction",
    "required": true
  },
  "isCashBackAllowed": {
    "description": "Set to true to allow cashback.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "isDebitSupported": {
    "description": "Set to true to allow debit only cards to be used. The credit functionality of check cards will still work if this is set to false.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "isEmvSupported": {
    "description": "Set to true to enable your application to accept EMV transactions. Set to false to not allow EMV transactions.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "isGiftSupported": {
    "description": "Set to true to allow gift only cards to be used. The credit functionality of check cards will still work if this is set to false.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "isTipAllowed": {
    "description": "Set to true to allow tips to be added.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "marketCode": {
    "description": "The market code specific to the type of transaction being submitted. This global value can be set, but it can be overridden on a per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": true
  },
  "signatureFormat": {
    "description": "The format which signature data should come back as.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": true
  },
  "store": {
    "description": "Store configuration to control the level of liability when using store and forward functions.",
    "type": "PUT_TransactionStoreConfiguration/v1/configuration/transaction",
    "required": true
  },
  "cashBackIncrement": {
    "description": "Increments you want customers to be able to get back. Common values include, 1, 5, 10 and 20.",
    "type": "int",
    "allowableValues": {},
    "required": false
  },
  "cashbackSelections": {
    "description": "Enter whole numbers separated by commas for the cashback amounts to select from.",
    "type": "Array",
    "items": {
      "type": "int"
    },
    "required": false
  },
  "decimalTipSelections": {
    "description": "Enter decimal numbers for tip amounts. If percent values were provided for tip amounts then these values will be ignored.",
    "type": "Array",
    "items": {
      "type": "double"
    },
    "required": false
  },
  "isCscSupported": {
    "description": "Set to true to prompt for CVV during manual card entry.",
    "type": "boolean",
    "allowableValues": {},
    "required": false
  },
  "isDebitRefundSupported": {
    "description": "Set to true to allow refunds onto a debit card. Not all processors support this.",
    "type": "boolean",
    "allowableValues": {},
    "required": false
  },
  "isHealthcareSupported": {
    "description": "If set to true, Healthcare fields are allowed.",
    "type": "boolean",
    "allowableValues": {},
    "required": false
  },
  "maximumCashbackAmount": {
    "description": "The maximum cashback amount you want to allow cardholders to get back",
    "type": "int",
    "allowableValues": {},
    "required": false
  },
  "noneTipSelection": {
    "description": "Enter true to show \"None\" on the PIN pad during tip selection. If false is entered \"Other\" will be shown instead.",
    "type": "boolean",
    "required": false
  },
  "otherCashbackSelection": {
    "description": "Enter true if you would like \"Other\" option to show up on cashback selection screen.",
    "type": "boolean",
    "allowableValues": {},
    "required": false
  },
  "percentTipSelections": {
    "description": "Enter decimal numbers to be used as percent values for tip amounts. This means { 10, 15.5, 20.0 } will become the following tip selections (10%, 15.5%, 20%). If percent values are provided for tip amounts then decimal tip amounts will be ignored.",
    "type": "Array",
    "items": {
      "type": "double"
    },
    "required": false
  }
}
TransactionForwardConfiguration 
{
  "forwardMode": {
    "description": "Allow triPOS to forward transactions automatically upon gaining connectivity, or merchant chooses to forward on per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PerRequest",
        "Automatic"
      ]
    },
    "required": false
  }
}
TransactionStoreConfiguration 
{
  "storeMode": {
    "description": "Allow triPOS to store transactions automatically upon losing connectivity, or merchant chooses to store on per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PerRequest",
        "Automatic"
      ]
    },
    "required": true
  },
  "unprocessedTotalAmountLimit": {
    "description": "When storing, triPOS will decline any transaction that causes the sum of all unprocessed transactions to exceed this maxiumum amount.",
    "type": "int",
    "required": false
  }
}

Response Class

UpdateTransactionConfigurationResponse 
{
  "forward": {
    "forwardMode": "string"
  },
  "isEmvSupported": "boolean",
  "store": {
    "storeMode": "string",
    "unprocessedTotalAmountLimit": "int"
  },
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "allowPartialApprovals": "boolean",
  "cashBackIncrement": "string",
  "cashBackSelections": "string",
  "checkForDuplicateTransactions": "boolean",
  "confirmConvenienceFeeAmount": "boolean",
  "confirmOriginalAmount": "boolean",
  "creditAvsEntryCondition": "string",
  "creditSaleSignatureThresholdAmount": "double",
  "currencyCode": "string",
  "debitSurcharge": "double",
  "emvFallbackAllowed": "string",
  "isCashBackAllowed": "boolean",
  "isCscSupported": "boolean",
  "isDebitRefundSupported": "boolean",
  "isDebitSupported": "boolean",
  "isGiftSupported": "boolean",
  "isHealthcareSupported": "boolean",
  "isTipAllowed": "boolean",
  "marketCode": "string",
  "maximumCashbackAmount": "int",
  "signatureFormat": "string",
  "tipSelections": "string",
  "transactionUpdated": "boolean"
}
UpdateTransactionConfigurationResponse
Field Required Data Type Description
forward true TransactionForwardConfiguration Forward configuration to control the level of liability when using store and forward functions.
isEmvSupported true boolean Set to true to enable your application to accept EMV transactions. Set to false to not allow EMV transactions.
store true TransactionStoreConfiguration Store configuration to control the level of liability when using store and forward functions.
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
allowPartialApprovals false boolean If set to true, partial approvals are allowed.
cashBackIncrement false string Increments you want customers to be able to get back. Common values include, 1, 5, 10 and 20.
cashBackSelections false string Enter whole numbers separated by commas for the cashback amounts to select from.
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host. This can be overridden on a per request basis.
confirmConvenienceFeeAmount false boolean Set to true to require the PIN pad to display a confirmation message to the cardholder for the convenienceFeeAmount.
confirmOriginalAmount false boolean If set to true, the PIN Pad will prompt the cardholder to confirm the original amount.
creditAvsEntryCondition false string Set to true when AVS entry (billing postal code entry) should be prompted for credit transactions.
Values:
  • Always
  • Never
  • Keyed
creditSaleSignatureThresholdAmount false double Leave as 0 or empty to always require a signature for credit sale, otherwise set to the amount that must be surpassed before asking for a signature, such as 25.00
currencyCode false string The currency code that will be used for all transactions.
Values:
  • None
  • Usd
debitSurcharge false double Enter a decimal amount to add to debit transactions. Please read the credit / debit card surcharge statutes as they pertain to your state of business: 'http://www.ncsl.org/research/financial-services-and-commerce/credit-or-debit-card-surcharges-statutes.aspx'
emvFallbackAllowed false string Allow Emv Fallback.
Values:
  • NeverAllow
  • AllowAfterChipError
isCashBackAllowed false boolean Set to true to allow cashback.
isCscSupported false boolean If set to true triPOS will prompt for CVV during manual card entry.
isDebitRefundSupported false boolean Set to true to allow refunds onto a debit card. Not all processors support this.
isDebitSupported false boolean Set to true to allow debit only cards to be used. The credit functionality of check cards will still work if this is set to false.
isGiftSupported false boolean Set to true to allow gift only cards to be used. The credit functionality of check cards will still work if this is set to false.
isHealthcareSupported false boolean If set to true, Healthcare fields are allowed.
isTipAllowed false boolean Set to true to allow tips to be added.
marketCode false string The market code specific to the type of transaction being submitted. Can be overridden on a per request basis.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
maximumCashbackAmount false int The maximum cashback amount you want to allow cardholders to get back
signatureFormat false string The format which signature data should come back as.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
tipSelections false string Enter decimal numbers for tip amounts. Add percent sign after the number to display a percent option rather than a dollar amount (i.e. 10%, 15%, 20%). If any value is a percentage, it is assumed that all values are percentages. Add 'none' to show "None" on the pin pad, otherwise "Other" will always be shown on the pin pad.
transactionUpdated false boolean True is transaction settings were updated successfully and false otherwise.
TransactionForwardConfiguration
Field Required Data Type Description
forwardMode false string Allow triPOS to forward transactions automatically upon gaining connectivity, or merchant chooses to forward on per request basis.
Values:
  • PerRequest
  • Automatic
TransactionStoreConfiguration
Field Required Data Type Description
storeMode true string Allow triPOS to store transactions automatically upon losing connectivity, or merchant chooses to store on per request basis.
Values:
  • PerRequest
  • Automatic
unprocessedTotalAmountLimit false int When storing, triPOS will decline any transaction that causes the sum of all unprocessed transactions to exceed this maxiumum amount.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
UpdateTransactionConfigurationResponse 
{
  "forward": {
    "description": "Forward configuration to control the level of liability when using store and forward functions.",
    "type": "TransactionForwardConfiguration",
    "required": true
  },
  "isEmvSupported": {
    "description": "Set to true to enable your application to accept EMV transactions. Set to false to not allow EMV transactions.",
    "type": "boolean",
    "allowableValues": {},
    "required": true
  },
  "store": {
    "description": "Store configuration to control the level of liability when using store and forward functions.",
    "type": "TransactionStoreConfiguration",
    "required": true
  },
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed.",
    "type": "boolean",
    "required": false
  },
  "cashBackIncrement": {
    "description": "Increments you want customers to be able to get back. Common values include, 1, 5, 10 and 20.",
    "type": "string",
    "required": false
  },
  "cashBackSelections": {
    "description": "Enter whole numbers separated by commas for the cashback amounts to select from.",
    "type": "string",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host. This can be overridden on a per request basis.",
    "type": "boolean",
    "required": false
  },
  "confirmConvenienceFeeAmount": {
    "description": "Set to true to require the PIN pad to display a confirmation message to the cardholder for the convenienceFeeAmount.",
    "type": "boolean",
    "required": false
  },
  "confirmOriginalAmount": {
    "description": "If set to true, the PIN Pad will prompt the cardholder to confirm the original amount.",
    "type": "boolean",
    "required": false
  },
  "creditAvsEntryCondition": {
    "description": "Set to true when AVS entry (billing postal code entry) should be prompted for credit transactions.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "Keyed"
      ]
    },
    "required": false
  },
  "creditSaleSignatureThresholdAmount": {
    "description": "Leave as 0 or empty to always require a signature for credit sale, otherwise set to the amount that must be surpassed before asking for a signature, such as 25.00",
    "type": "double",
    "required": false
  },
  "currencyCode": {
    "description": "The currency code that will be used for all transactions.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": false
  },
  "debitSurcharge": {
    "description": "Enter a decimal amount to add to debit transactions. Please read the credit / debit card surcharge statutes as they pertain to your state of business: 'http://www.ncsl.org/research/financial-services-and-commerce/credit-or-debit-card-surcharges-statutes.aspx'",
    "type": "double",
    "required": false
  },
  "emvFallbackAllowed": {
    "description": "Allow Emv Fallback.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NeverAllow",
        "AllowAfterChipError"
      ]
    },
    "required": false
  },
  "isCashBackAllowed": {
    "description": "Set to true to allow cashback.",
    "type": "boolean",
    "required": false
  },
  "isCscSupported": {
    "description": "If set to true triPOS will prompt for CVV during manual card entry.",
    "type": "boolean",
    "required": false
  },
  "isDebitRefundSupported": {
    "description": "Set to true to allow refunds onto a debit card. Not all processors support this.",
    "type": "boolean",
    "required": false
  },
  "isDebitSupported": {
    "description": "Set to true to allow debit only cards to be used. The credit functionality of check cards will still work if this is set to false.",
    "type": "boolean",
    "required": false
  },
  "isGiftSupported": {
    "description": "Set to true to allow gift only cards to be used. The credit functionality of check cards will still work if this is set to false.",
    "type": "boolean",
    "required": false
  },
  "isHealthcareSupported": {
    "description": "If set to true, Healthcare fields are allowed.",
    "type": "boolean",
    "allowableValues": {},
    "required": false
  },
  "isTipAllowed": {
    "description": "Set to true to allow tips to be added.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code specific to the type of transaction being submitted. Can be overridden on a per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  },
  "maximumCashbackAmount": {
    "description": "The maximum cashback amount you want to allow cardholders to get back",
    "type": "int",
    "required": false
  },
  "signatureFormat": {
    "description": "The format which signature data should come back as.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "tipSelections": {
    "description": "Enter decimal numbers for tip amounts. Add percent sign after the number to display a percent option rather than a dollar amount (i.e. 10%, 15%, 20%). If any value is a percentage, it is assumed that all values are percentages. Add 'none' to show \"None\" on the pin pad, otherwise \"Other\" will always be shown on the pin pad.",
    "type": "string",
    "required": false
  },
  "transactionUpdated": {
    "description": "True is transaction settings were updated successfully and false otherwise.",
    "type": "boolean",
    "required": false
  }
}
TransactionForwardConfiguration 
{
  "forwardMode": {
    "description": "Allow triPOS to forward transactions automatically upon gaining connectivity, or merchant chooses to forward on per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PerRequest",
        "Automatic"
      ]
    },
    "required": false
  }
}
TransactionStoreConfiguration 
{
  "storeMode": {
    "description": "Allow triPOS to store transactions automatically upon losing connectivity, or merchant chooses to store on per request basis.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PerRequest",
        "Automatic"
      ]
    },
    "required": true
  },
  "unprocessedTotalAmountLimit": {
    "description": "When storing, triPOS will decline any transaction that causes the sum of all unprocessed transactions to exceed this maxiumum amount.",
    "type": "int",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
POST
/api/v1/display Displays a text on the PIN pad.

Implementation Notes

Use the display endpoint to display a text on the PIN pad. This endpoint returns an HTTP status code of 200 if the text was successfully displayed on the PIN pad. See display documentation fore more information.

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
DisplayRequest body POST_DisplayRequest/v1/display undefined

Request Class

DisplayRequest 
{
  "laneId": "int",
  "text": "string"
}
DisplayRequest
Field Required Data Type Description
laneId true int The lane ID.
text false string The text to display on the PIN pad.
DisplayRequest 
{
  "laneId": {
    "description": "The lane ID.",
    "type": "int",
    "required": true
  },
  "text": {
    "description": "The text to display on the PIN pad.",
    "type": "string",
    "required": false
  }
}

Response Class

DisplayResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
DisplayResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
DisplayResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if parameter values are missing or invalid.
GET
/api/v1/force Returns a the list of force endpoints

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

ForceResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
ForceResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
ForceResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
POST
/api/v1/force/credit Creates a new credit card force based on the passed in amounts

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
ForceCreditRequest body POST_ForceCreditRequest/v1/force/credit undefined

Request Class

ForceCreditRequest 
{
  "approvalNumber": "string",
  "laneId": "int",
  "transactionAmount": "double",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "commercialCardCustomerCode": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string",
    "promptForSignature": "string"
  },
  "lodging": {
    "agreementNumber": "string",
    "chargeType": "string",
    "checkInDate": "string",
    "checkOutDate": "string",
    "customerName": "string",
    "duration": "int",
    "extraChargesDetail": "Array<POST_LodgingExtraChargesDetail/v1/force/credit>",
    "noShow": "boolean",
    "prestigiousPropertyCode": "string",
    "roomAmount": "double",
    "specialProgramCode": "string"
  },
  "referenceNumber": "string",
  "salesTaxAmount": "double",
  "shiftId": "string",
  "ticketNumber": "string"
}
ForceCreditRequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string",
  "promptForSignature": "string"
}
ForceCreditRequest
Field Required Data Type Description
approvalNumber true string The approval number of a voice authorization
laneId true int Specifies which lane to use.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
address false POST_Address/v1/force/credit The cardholder address information for the transaction.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
commercialCardCustomerCode false string The commercial card customer code for the transaction. This is for Level II.
configuration false POST_ForceCreditRequestConfiguration/v1/force/credit Any value included in this section will override the corresponding value set in the triPOS.config
lodging false POST_LodgingTransactionCompletion/v1/force/credit The lodging parameters to be passed in for a lodging transaction. more»
referenceNumber false string A user defined reference number.
salesTaxAmount false double The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
ForceCreditRequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
promptForSignature false string Specifies how the signature prompt should be handled for the request. If a value is not provided, Never will be used. See Signature Prompt.
Values:
  • Always
  • Never
  • None
LodgingTransactionCompletion
Field Required Data Type Description
agreementNumber false string The lodging agreement number.
chargeType false string The lodging charge type. For an empty or invalid value, this parameter defaults to Default.
Values:
  • Default
  • Restaurant
  • GiftShop
checkInDate false string The check-in date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.
checkOutDate false string The check-out date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.
customerName false string The lodging customer name.
duration false int The number of hotel stay days. Set to 1 for no show.
extraChargesDetail false Array<POST_LodgingExtraChargesDetail/v1/force/credit> Pass in up to 6 values that describe the extra charges. For an empty or invalid value, this parameter defaults to NotUsed.
Values:
  • NotUsed
  • Reserved
  • Restaurant
  • GiftShop
  • MiniBar
  • Telephone
  • Other
  • Laundry
noShow false boolean Set to true to indicate no show. Otherwise, value defaults to false.
prestigiousPropertyCode false string The lodging prestigious property code. For an empty or invalid value, this parameter defaults to NonParticipant.
Values:
  • NonParticipant
  • FiveHundredDollarLimit
  • OneThousandDollarLimit
  • OneThousandFiveHundredDollarLimit
roomAmount false double The nightly rate for one room.
specialProgramCode false string The lodging special program code. For an empty or invalid value, this parameter defaults to Default.
Values:
  • Default
  • Sale
  • NoShow
  • AdvanceDeposit
ForceCreditRequest 
{
  "approvalNumber": {
    "description": "The approval number of a voice authorization",
    "type": "string",
    "required": true
  },
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/force/credit",
    "required": false
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "commercialCardCustomerCode": {
    "description": "The commercial card customer code for the transaction. This is for Level II.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_ForceCreditRequestConfiguration/v1/force/credit",
    "required": false
  },
  "lodging": {
    "description": "The lodging parameters to be passed in for a lodging transaction. <a href='../help/kb/lodging.html'>more&raquo;</a>",
    "type": "POST_LodgingTransactionCompletion/v1/force/credit",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "salesTaxAmount": {
    "description": "The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.",
    "type": "double",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}
ForceCreditRequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  },
  "promptForSignature": {
    "description": "Specifies how the signature prompt should be handled for the request. If a value is not provided, Never will be used. See <a href='../help/kb/signaturePrompt.html'>Signature Prompt</a>.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "None"
      ]
    },
    "required": false
  }
}
LodgingTransactionCompletion 
{
  "agreementNumber": {
    "description": "The lodging agreement number.",
    "type": "string",
    "required": false
  },
  "chargeType": {
    "description": "The lodging charge type. For an empty or invalid value, this parameter defaults to Default.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Restaurant",
        "GiftShop"
      ]
    },
    "required": false
  },
  "checkInDate": {
    "description": "The check-in date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.",
    "type": "string",
    "required": false
  },
  "checkOutDate": {
    "description": "The check-out date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.",
    "type": "string",
    "required": false
  },
  "customerName": {
    "description": "The lodging customer name.",
    "type": "string",
    "required": false
  },
  "duration": {
    "description": "The number of hotel stay days. Set to 1 for no show.",
    "type": "int",
    "required": false
  },
  "extraChargesDetail": {
    "description": "Pass in up to 6 values that describe the extra charges. For an empty or invalid value, this parameter defaults to NotUsed.",
    "type": "Array",
    "items": {
      "type": "POST_LodgingExtraChargesDetail/v1/force/credit"
    },
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NotUsed",
        "Reserved",
        "Restaurant",
        "GiftShop",
        "MiniBar",
        "Telephone",
        "Other",
        "Laundry"
      ]
    },
    "required": false
  },
  "noShow": {
    "description": "Set to true to indicate no show. Otherwise, value defaults to false.",
    "type": "boolean",
    "required": false
  },
  "prestigiousPropertyCode": {
    "description": "The lodging prestigious property code. For an empty or invalid value, this parameter defaults to NonParticipant.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NonParticipant",
        "FiveHundredDollarLimit",
        "OneThousandDollarLimit",
        "OneThousandFiveHundredDollarLimit"
      ]
    },
    "required": false
  },
  "roomAmount": {
    "description": "The nightly rate for one room.",
    "type": "double",
    "required": false
  },
  "specialProgramCode": {
    "description": "The lodging special program code. For an empty or invalid value, this parameter defaults to Default.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Sale",
        "NoShow",
        "AdvanceDeposit"
      ]
    },
    "required": false
  }
}

Response Class

CreditCardForceResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "currencyCode": "string",
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentType": "string",
  "pinVerified": "boolean",
  "signature": {
    "data": "Array<byte>",
    "format": "string",
    "statusCode": "string"
  },
  "statusCode": "string",
  "terminalId": "string",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
CreditCardForceResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
binValue false string The BIN entry that matched the account number.
cardHolderName false string The cardholder name.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
currencyCode false string The currency code used in the transaction.
Values:
  • None
  • Usd
entryMode false string Description of how card was entered.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentType false string Description of payment type utilized.
Values:
  • None
  • Credit
  • Debit
  • Gift
pinVerified false boolean True if the PIN was verified, false if not verified or undetermined.
signature false Signature The signature data.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Signature
Field Required Data Type Description
data false Array<byte> The byte array of the signature in the format specified by Format.
format false string The format of the signature.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
statusCode false string Indicates why a signature is or is not present.
Values:
  • Unknown
  • SignatureRequired
  • SignaturePresent
  • SignatureRequiredCancelledByCardholder
  • SignatureRequiredNotSupportedByPinPad
  • SignatureRequiredPinPadError
  • SignatureNotRequiredByThresholdAmount
  • SignatureNotRequiredByPaymentType
  • SignatureNotRequiredByTransactionType
  • SignatureRequiredButPromptSuppressedByMerchant
CreditCardForceResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The cardholder name.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "currencyCode": {
    "description": "The currency code used in the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentType": {
    "description": "Description of payment type utilized.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Credit",
        "Debit",
        "Gift"
      ]
    },
    "required": false
  },
  "pinVerified": {
    "description": "True if the PIN was verified, false if not verified or undetermined.",
    "type": "boolean",
    "required": false
  },
  "signature": {
    "description": "The signature data.",
    "type": "Signature",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Signature 
{
  "data": {
    "description": "The byte array of the signature in the format specified by Format.",
    "type": "Array",
    "items": {
      "type": "byte"
    },
    "required": false
  },
  "format": {
    "description": "The format of the signature.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "statusCode": {
    "description": "Indicates why a signature is or is not present.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "SignatureRequired",
        "SignaturePresent",
        "SignatureRequiredCancelledByCardholder",
        "SignatureRequiredNotSupportedByPinPad",
        "SignatureRequiredPinPadError",
        "SignatureNotRequiredByThresholdAmount",
        "SignatureNotRequiredByPaymentType",
        "SignatureNotRequiredByTransactionType",
        "SignatureRequiredButPromptSuppressedByMerchant"
      ]
    },
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if MarketCode is not HotelLodging but the request includes lodging parameters on a valid lodging request.
400 Returned if the lodging checkInDate or checkOutDate is not in the ISO 8601 format of YYYY-MM-DD on a valid lodging request.
400 Returned if the lodging roomAmount is less than 0.00 on a valid lodging request.
400 Returned if the lodging duration is less than 0 on a valid lodging request.
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
GET
/api/v1/gift Return the endpoints used to manage Vantiv Gift Cards

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GiftResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
GiftResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
GiftResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
POST
/api/v1/gift/activate Activates the given gift card with the specified amount

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
ActivateGiftRequest body POST_ActivateGiftRequest/v1/gift/activate undefined

Request Class

ActivateGiftRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string"
  },
  "referenceNumber": "string",
  "shiftId": "string",
  "ticketNumber": "string"
}
RequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string"
}
ActivateGiftRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
configuration false POST_RequestConfiguration/v1/gift/activate Any value included in this section will override the corresponding value set in the triPOS.config
referenceNumber false string A user defined reference number.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
RequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
ActivateGiftRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_RequestConfiguration/v1/gift/activate",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  }
}
RequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  }
}

Response Class

ActivateGiftResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "balanceAmount": "double",
  "balanceCurrencyCode": "string",
  "binValue": "string",
  "cardLogo": "string",
  "entryMode": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "statusCode": "string",
  "terminalId": "string",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
ActivateGiftResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
balanceAmount false double The balance of the gift card.
balanceCurrencyCode false string The balance currency code.
binValue false string The BIN entry that matched the account number.
cardLogo false string The card logo (e.g. Visa, Mastercard, etc).
entryMode false string Description of how card was entered: Keyed, Swiped, Chip.
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
ActivateGiftResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "balanceAmount": {
    "description": "The balance of the gift card.",
    "type": "double",
    "required": false
  },
  "balanceCurrencyCode": {
    "description": "The balance currency code.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo (e.g. Visa, Mastercard, etc).",
    "type": "string",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered: Keyed, Swiped, Chip.",
    "type": "string",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
POST
/api/v1/idle Displays the idle screen on the specified PIN pad.

Implementation Notes

Use the idle endpoint to return the PIN pad to the idle screen. See idle documentation for more information.

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
IdleRequest body POST_IdleRequest/v1/idle undefined

Request Class

IdleRequest 
{
  "laneId": "int"
}
IdleRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
IdleRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  }
}

Response Class

IdleResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
IdleResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
IdleResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if the laneId is not valid or the lane is already in use
500 Returned if the PIN pad is disconnected
GET
/api/v1/input/{laneId} Displays the prompt associated to the promptType and accepts input text from the card holder

Implementation Notes

Use the input endpoint to prompt the cardholder for input. This endpoint returns an HTTP status code of 200 if the cardholder pressed the ok or cancel button. See input documentation for more information.

Parameters

Parameter Parameter Type Data Type Description
laneId path string The lane ID.
promptType query string The type of prompt to display on the PIN pad. more»
formatType query string The PIN pad uses this format to display the input on the PIN pad as the cardholder enters it. more»
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

InputResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "cardholderAction": "string",
  "inputText": "string"
}
InputResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
cardholderAction false string The cardholder interaction with the PIN pad.
Values:
  • OK
  • Cancel
  • Timeout
inputText false string The raw, unformatted text that the cardholder entered into the input field on the PIN pad.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
InputResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "cardholderAction": {
    "description": "The cardholder interaction with the PIN pad.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "OK",
        "Cancel",
        "Timeout"
      ]
    },
    "required": false
  },
  "inputText": {
    "description": "The raw, unformatted text that the cardholder entered into the input field on the PIN pad.",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if parameter values are missing or invalid.
417 Returned if the cardholder does not respond within the specified amount of time.
POST
/api/v1/paymentAccount Creates a card account token based on the given data

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
CreatePaymentAccountCreditRequest body POST_CreatePaymentAccountCreditRequest/v1/paymentAccount undefined

Request Class

CreatePaymentAccountCreditRequest 
{
  "laneId": "int",
  "paymentAccountReferenceNumber": "string",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "expirationMonth": "string",
  "expirationYear": "string"
}
CreatePaymentAccountCreditRequest
Field Required Data Type Description
laneId true int The lane ID.
paymentAccountReferenceNumber true string The payment account reference number
address false POST_Address/v1/paymentAccount The cardholder address information for the transaction.
expirationMonth false string The expiration month.
expirationYear false string The expiration year.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
CreatePaymentAccountCreditRequest 
{
  "laneId": {
    "description": "The lane ID.",
    "type": "int",
    "required": true
  },
  "paymentAccountReferenceNumber": {
    "description": "The payment account reference number",
    "type": "string",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/paymentAccount",
    "required": false
  },
  "expirationMonth": {
    "description": "The expiration month.",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The expiration year.",
    "type": "string",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}

Response Class

CreatePaymentAccountCreditResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "fsaCard": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentAccountId": "string",
  "paymentAccountReferenceNumber": "string",
  "statusCode": "string",
  "terminalId": "string",
  "transactionDateTime": "string",
  "transactionId": "string"
}
CreatePaymentAccountCreditResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The credit card number with the value masked except for the last 4.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
binValue false string The BIN entry that matched the account number.
cardHolderName false string The cardholder name.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
entryMode false string Description of how card was entered.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
fsaCard false string Indicates whether the card used was a FSA card.
Note: Maybe = No BIN entry to determine if FSA.
Values:
  • NotApplicable
  • No
  • Yes
  • Maybe
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentAccountId false string the payment account ID.
paymentAccountReferenceNumber false string the payment account reference number.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
CreatePaymentAccountCreditResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The credit card number with the value masked except for the last 4.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The cardholder name.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "fsaCard": {
    "description": "Indicates whether the card used was a FSA card.<br />Note: Maybe = No BIN entry to determine if FSA.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NotApplicable",
        "No",
        "Yes",
        "Maybe"
      ]
    },
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentAccountId": {
    "description": "the payment account ID.",
    "type": "string",
    "required": false
  },
  "paymentAccountReferenceNumber": {
    "description": "the payment account reference number.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction.",
    "type": "string",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
PUT
/api/v1/paymentAccount/{paymentAccountId} Updates a payment account based on the given data

Parameters

Parameter Parameter Type Data Type Description
paymentAccountId path string The payment account ID to update.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
UpdatePaymentAccountCreditRequest body PUT_UpdatePaymentAccountCreditRequest/v1/paymentAccount/{paymentAccountId} undefined

Request Class

UpdatePaymentAccountCreditRequest 
{
  "paymentAccountReferenceNumber": "string",
  "updateCardData": "boolean",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "expirationMonth": "string",
  "expirationYear": "string",
  "laneId": "int"
}
UpdatePaymentAccountCreditRequest
Field Required Data Type Description
paymentAccountReferenceNumber true string The payment account reference number
updateCardData true boolean The value that is passed in for UpdateCardData. Should be true or false.
address false PUT_Address/v1/paymentAccount/{paymentAccountId} The cardholder address information for the transaction.
expirationMonth false string The expiration month.
expirationYear false string The expiration year.
laneId false int The Lane ID.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
UpdatePaymentAccountCreditRequest 
{
  "paymentAccountReferenceNumber": {
    "description": "The payment account reference number",
    "type": "string",
    "required": true
  },
  "updateCardData": {
    "description": "The value that is passed in for UpdateCardData. Should be true or false.",
    "type": "boolean",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "PUT_Address/v1/paymentAccount/{paymentAccountId}",
    "required": false
  },
  "expirationMonth": {
    "description": "The expiration month.",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The expiration year.",
    "type": "string",
    "required": false
  },
  "laneId": {
    "description": "The Lane ID.",
    "type": "int",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}

Response Class

UpdatePaymentAccountCreditResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "fsaCard": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentAccountId": "string",
  "paymentAccountReferenceNumber": "string",
  "statusCode": "string",
  "terminalId": "string",
  "transactionDateTime": "string",
  "transactionId": "string"
}
UpdatePaymentAccountCreditResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The credit card number with the value masked except for the last 4. This field is only available when updateCardData is set to true in the request.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
binValue false string The BIN entry that matched the account number. This field is only available when updateCardData is set to true in the request.
cardHolderName false string The cardholder name. This field is only available when updateCardData is set to true in the request.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other. This field is only available when updateCardData is set to true in the request.
entryMode false string Description of how card was entered. This field is only available when updateCardData is set to true in the request.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month. This field is only available when updateCardData is set to true in the request.
expirationYear false string The card's expiration year. This field is only available when updateCardData is set to true in the request.
fsaCard false string Indicates whether the card used was a FSA card. This field is only available when updateCardData is set to true in the request.
Note: Maybe = No BIN entry to determine if FSA.
Values:
  • NotApplicable
  • No
  • Yes
  • Maybe
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentAccountId false string the payment account ID.
paymentAccountReferenceNumber false string the payment account reference number.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
UpdatePaymentAccountCreditResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The credit card number with the value masked except for the last 4. This field is only available when <code>updateCardData</code> is set to true in the request.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number. This field is only available when <code>updateCardData</code> is set to true in the request.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The cardholder name. This field is only available when <code>updateCardData</code> is set to true in the request.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other. This field is only available when <code>updateCardData</code> is set to true in the request.",
    "type": "string",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered. This field is only available when <code>updateCardData</code> is set to true in the request.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month. This field is only available when <code>updateCardData</code> is set to true in the request.",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year. This field is only available when <code>updateCardData</code> is set to true in the request.",
    "type": "string",
    "required": false
  },
  "fsaCard": {
    "description": "Indicates whether the card used was a FSA card. This field is only available when <code>updateCardData</code> is set to true in the request.<br />Note: Maybe = No BIN entry to determine if FSA.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NotApplicable",
        "No",
        "Yes",
        "Maybe"
      ]
    },
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentAccountId": {
    "description": "the payment account ID.",
    "type": "string",
    "required": false
  },
  "paymentAccountReferenceNumber": {
    "description": "the payment account reference number.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction.",
    "type": "string",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
DELETE
/api/v1/paymentAccount/{paymentAccountId} Marks the given payment account for deletion

Implementation Notes

This endpoint deletes a payment account created with POST /api/v1/paymentAccount. This endpoint returns an HTTP status code of 200 if the payment account was successfully deleted. Other HTTP status code responses indicate failure. If the payment account is not found, an HTTP status code 404 is returned. After a successful delete, this endpoint will continue to return HTTP status code 200 until the Express processing platform purges the payment account from the system. Payment account purge typically happens within 48 hours. After 48 hours, this endpoint will return a 404 Not Found HTTP status code for the deleted payment account.

Parameters

Parameter Parameter Type Data Type Description
laneId body int The lane ID.
paymentAccountId path string The payment account ID to update.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Request Class

Response Class

DeletePaymentAccountResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "merchantId": "string",
  "paymentAccountId": "string",
  "terminalId": "string",
  "transactionDateTime": "string"
}
DeletePaymentAccountResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
merchantId false string The merchant ID.
paymentAccountId false string The payment account ID that was deleted.
terminalId false string The ID of the terminal used during the transaction
transactionDateTime false string Transaction date/time in ISO8601 format
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
DeletePaymentAccountResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "merchantId": {
    "description": "The merchant ID.",
    "type": "string",
    "required": false
  },
  "paymentAccountId": {
    "description": "The payment account ID that was deleted.",
    "type": "string",
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
404 The payment account ID could not be found. No action taken, tripos returns an HTTP status code of 404.
POST
/api/v1/refund Creates a new card refund based on the passed in parameters

Implementation Notes

Creates a new card refund based on the passed in parameters. More»

Parameters

Parameter Parameter Type Data Type Description
action query string The action to perform with the refund. This can either be 'store' or 'forward'. More information on Store and Forward here.
requestIdToForward query string The request ID of the stored transaction to forward.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
RefundRequest body POST_RefundRequest/v1/refund undefined

Request Class

RefundRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "commercialCardCustomerCode": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string",
    "promptForSignature": "string"
  },
  "convenienceFeeAmount": "double",
  "referenceNumber": "string",
  "salesTaxAmount": "double",
  "shiftId": "string",
  "ticketNumber": "string"
}
RefundRequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string",
  "promptForSignature": "string"
}
RefundRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
address false POST_Address/v1/refund The cardholder address information for the transaction.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
commercialCardCustomerCode false string The commercial card customer code for the transaction. This is for Level II.
configuration false POST_RefundRequestConfiguration/v1/refund Any value included in this section will override the corresponding value set in the triPOS.config
convenienceFeeAmount false double The convenience fee amount.
referenceNumber false string A user defined reference number.
salesTaxAmount false double The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
RefundRequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
promptForSignature false string Specifies how the signature prompt should be handled for the request. If a value is not provided, Always will be used. See Signature Prompt.
Values:
  • Always
  • Never
  • None
RefundRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/refund",
    "required": false
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "commercialCardCustomerCode": {
    "description": "The commercial card customer code for the transaction. This is for Level II.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_RefundRequestConfiguration/v1/refund",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount.",
    "type": "double",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "salesTaxAmount": {
    "description": "The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.",
    "type": "double",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}
RefundRequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  },
  "promptForSignature": {
    "description": "Specifies how the signature prompt should be handled for the request. If a value is not provided, Always will be used.  See <a href='../help/kb/signaturePrompt.html'>Signature Prompt</a>.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "None"
      ]
    },
    "required": false
  }
}

Response Class

RefundResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "convenienceFeeAmount": "double",
  "currencyCode": "string",
  "emv": {
    "applicationIdentifier": "string",
    "applicationLabel": "string",
    "applicationPreferredName": "string",
    "cryptogram": "string",
    "issuerCodeTableIndex": "string",
    "tags": {
      "key": "string",
      "value": "string"
    }
  },
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentType": "string",
  "pinVerified": "boolean",
  "signature": {
    "data": "Array<byte>",
    "format": "string",
    "statusCode": "string"
  },
  "statusCode": "string",
  "terminalId": "string",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
RefundResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
binValue false string The BIN entry that matched the account number.
cardHolderName false string The cardholder name.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
convenienceFeeAmount false double The convenience fee amount.
currencyCode false string The currency code used in the transaction.
Values:
  • None
  • Usd
emv false Emv The fields used on the receipt for an EMV transaction. Null if the transaction was not EMV.
entryMode false string Description of how card was entered.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentType false string Description of payment type utilized.
Values:
  • None
  • Credit
  • Debit
  • Gift
pinVerified false boolean True if the PIN was verified, false if not verified or undetermined.
signature false Signature The signature data.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Emv
Field Required Data Type Description
applicationIdentifier false string The Application Identifier also known as the AID. Identifies the application as described in ISO/IEC 7816-5. Printed receipts are required to contain the AID as hexadecimal characters.
applicationLabel false string Mnemonic associated with the AID according to ISO/IEC 7816-5. If the Application Preferred Name is not available or the Issuer code table index is not supported, then the Application Label should be used on the receipt instead of the Application Preferred Name.
applicationPreferredName false string Preferred mnemonic associated with the AID. When the Application Preferred Name is present and the Issuer code table index is supported, then this data element is mandatory on the receipt.
cryptogram false string The EMV cryptogram type and value. It is a preferred best practice to include this data element on the receipt, but is not mandatory. This field contains cryptogram type followed by the cryptogram value.
issuerCodeTableIndex false string Indicates the code table according to ISO/IEC 8859 for displaying the Application Preferred Name.
tags false Array<Tag> A name value collection of additional EMV tags that are required to appear on the receipt.
Tag
Field Required Data Type Description
key false string undefined
value false string undefined
Signature
Field Required Data Type Description
data false Array<byte> The byte array of the signature in the format specified by Format.
format false string The format of the signature.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
statusCode false string Indicates why a signature is or is not present.
Values:
  • Unknown
  • SignatureRequired
  • SignaturePresent
  • SignatureRequiredCancelledByCardholder
  • SignatureRequiredNotSupportedByPinPad
  • SignatureRequiredPinPadError
  • SignatureNotRequiredByThresholdAmount
  • SignatureNotRequiredByPaymentType
  • SignatureNotRequiredByTransactionType
  • SignatureRequiredButPromptSuppressedByMerchant
RefundResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The cardholder name.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount.",
    "type": "double",
    "required": false
  },
  "currencyCode": {
    "description": "The currency code used in the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": false
  },
  "emv": {
    "description": "The fields used on the receipt for an EMV transaction. Null if the transaction was not EMV.",
    "type": "Emv",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentType": {
    "description": "Description of payment type utilized.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Credit",
        "Debit",
        "Gift"
      ]
    },
    "required": false
  },
  "pinVerified": {
    "description": "True if the PIN was verified, false if not verified or undetermined.",
    "type": "boolean",
    "required": false
  },
  "signature": {
    "description": "The signature data.",
    "type": "Signature",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Emv 
{
  "applicationIdentifier": {
    "description": "The Application Identifier also known as the AID. Identifies the application as described in ISO/IEC 7816-5. Printed receipts are required to contain the AID as hexadecimal characters.",
    "type": "string",
    "required": false
  },
  "applicationLabel": {
    "description": "Mnemonic associated with the AID according to ISO/IEC 7816-5. If the Application Preferred Name is not available or the Issuer code table index is not supported, then the Application Label should be used on the receipt instead of the Application Preferred Name.",
    "type": "string",
    "required": false
  },
  "applicationPreferredName": {
    "description": "Preferred mnemonic associated with the AID. When the Application Preferred Name is present and the Issuer code table index is supported, then this data element is mandatory on the receipt.",
    "type": "string",
    "required": false
  },
  "cryptogram": {
    "description": "The EMV cryptogram type and value. It is a preferred best practice to include this data element on the receipt, but is not mandatory. This field contains cryptogram type followed by the cryptogram value.",
    "type": "string",
    "required": false
  },
  "issuerCodeTableIndex": {
    "description": "Indicates the code table according to ISO/IEC 8859 for displaying the Application Preferred Name.",
    "type": "string",
    "required": false
  },
  "tags": {
    "description": "A name value collection of additional EMV tags that are required to appear on the receipt.",
    "type": "Array",
    "items": {
      "$ref": "Tag"
    },
    "required": false
  }
}
Tag 
{
  "key": {
    "type": "string",
    "required": false
  },
  "value": {
    "type": "string",
    "required": false
  }
}
Signature 
{
  "data": {
    "description": "The byte array of the signature in the format specified by Format.",
    "type": "Array",
    "items": {
      "type": "byte"
    },
    "required": false
  },
  "format": {
    "description": "The format of the signature.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "statusCode": {
    "description": "Indicates why a signature is or is not present.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "SignatureRequired",
        "SignaturePresent",
        "SignatureRequiredCancelledByCardholder",
        "SignatureRequiredNotSupportedByPinPad",
        "SignatureRequiredPinPadError",
        "SignatureNotRequiredByThresholdAmount",
        "SignatureNotRequiredByPaymentType",
        "SignatureNotRequiredByTransactionType",
        "SignatureRequiredButPromptSuppressedByMerchant"
      ]
    },
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
POST
/api/v1/refund/{paymentAccountId} Creates a new payment account refund based on the passed in parameters

Parameters

Parameter Parameter Type Data Type Description
paymentAccountId path string The payment account ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
PaymentAccountRefundRequest body POST_PaymentAccountRefundRequest/v1/refund/{paymentAccountId} undefined

Request Class

PaymentAccountRefundRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "clerkNumber": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string"
  },
  "convenienceFeeAmount": "double",
  "referenceNumber": "string",
  "shiftId": "string",
  "ticketNumber": "string"
}
RequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string"
}
PaymentAccountRefundRequest
Field Required Data Type Description
laneId true int Specifies which lane to use for the card sale.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
clerkNumber false string An optional clerk number for reference.
configuration false POST_RequestConfiguration/v1/refund/{paymentAccountId} Any value included in this section will override the corresponding value set in the triPOS.config
convenienceFeeAmount false double The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged
referenceNumber false string A user defined reference number.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
RequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
PaymentAccountRefundRequest 
{
  "laneId": {
    "description": "Specifies which lane to use for the card sale.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_RequestConfiguration/v1/refund/{paymentAccountId}",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged",
    "type": "double",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  }
}
RequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  }
}

Response Class

PaymentAccountRefundResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "approvalNumber": "string",
  "cardLogo": "string",
  "convenienceFeeAmount": "double",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentAccountId": "string",
  "paymentAccountReferenceNumber": "string",
  "referenceNumber": "string",
  "statusCode": "string",
  "terminalId": "string",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
PaymentAccountRefundResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
convenienceFeeAmount false double The convenience fee added to the transaction
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentAccountId false string The payment account ID.
paymentAccountReferenceNumber false string The payment account reference number.
referenceNumber false string The reference number.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
PaymentAccountRefundResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee added to the transaction",
    "type": "double",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentAccountId": {
    "description": "The payment account ID.",
    "type": "string",
    "required": false
  },
  "paymentAccountReferenceNumber": {
    "description": "The payment account reference number.",
    "type": "string",
    "required": false
  },
  "referenceNumber": {
    "description": "The reference number.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
POST
/api/v1/return/{transactionId}/{paymentType} Creates a new card return based on the passed in parameters

Implementation Notes

Creates a new card return based on the passed in parameters. More»

Parameters

Parameter Parameter Type Data Type Description
paymentType path string The original payment type.
transactionId path string The ID of a previous transaction.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
ReturnRequest body POST_ReturnRequest/v1/return/{transactionId}/{paymentType} undefined

Request Class

ReturnRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "commercialCardCustomerCode": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string",
    "promptForSignature": "string"
  },
  "referenceNumber": "string",
  "salesTaxAmount": "double",
  "shiftId": "string",
  "ticketNumber": "string"
}
ReturnRequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string",
  "promptForSignature": "string"
}
ReturnRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
address false POST_Address/v1/return/{transactionId}/{paymentType} The cardholder address information for the transaction.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
commercialCardCustomerCode false string The commercial card customer code for the transaction. This is for Level II.
configuration false POST_ReturnRequestConfiguration/v1/return/{transactionId}/{paymentType} Any value included in this section will override the corresponding value set in the triPOS.config
referenceNumber false string A user defined reference number.
salesTaxAmount false double The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
ReturnRequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
promptForSignature false string Specifies how the signature prompt should be handled for the request. If a value is not provided, Always will be used. See Signature Prompt.
Values:
  • Always
  • Never
  • None
ReturnRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/return/{transactionId}/{paymentType}",
    "required": false
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "commercialCardCustomerCode": {
    "description": "The commercial card customer code for the transaction. This is for Level II.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_ReturnRequestConfiguration/v1/return/{transactionId}/{paymentType}",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "salesTaxAmount": {
    "description": "The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.",
    "type": "double",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}
ReturnRequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  },
  "promptForSignature": {
    "description": "Specifies how the signature prompt should be handled for the request. If a value is not provided, Always will be used. See <a href='../help/kb/signaturePrompt.html'>Signature Prompt</a>.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "None"
      ]
    },
    "required": false
  }
}

Response Class

ReturnResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "currencyCode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentType": "string",
  "pinVerified": "boolean",
  "signature": {
    "data": "Array<byte>",
    "format": "string",
    "statusCode": "string"
  },
  "statusCode": "string",
  "terminalId": "string",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
ReturnResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
binValue false string The BIN entry that matched the account number.
cardHolderName false string The cardholder name.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
currencyCode false string The currency code used in the transaction.
Values:
  • None
  • Usd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentType false string Description of payment type utilized.
Values:
  • None
  • Credit
  • Debit
  • Gift
pinVerified false boolean True if the PIN was verified, false if not verified or undetermined.
signature false Signature The signature data.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Signature
Field Required Data Type Description
data false Array<byte> The byte array of the signature in the format specified by Format.
format false string The format of the signature.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
statusCode false string Indicates why a signature is or is not present.
Values:
  • Unknown
  • SignatureRequired
  • SignaturePresent
  • SignatureRequiredCancelledByCardholder
  • SignatureRequiredNotSupportedByPinPad
  • SignatureRequiredPinPadError
  • SignatureNotRequiredByThresholdAmount
  • SignatureNotRequiredByPaymentType
  • SignatureNotRequiredByTransactionType
  • SignatureRequiredButPromptSuppressedByMerchant
ReturnResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The cardholder name.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "currencyCode": {
    "description": "The currency code used in the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentType": {
    "description": "Description of payment type utilized.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Credit",
        "Debit",
        "Gift"
      ]
    },
    "required": false
  },
  "pinVerified": {
    "description": "True if the PIN was verified, false if not verified or undetermined.",
    "type": "boolean",
    "required": false
  },
  "signature": {
    "description": "The signature data.",
    "type": "Signature",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Signature 
{
  "data": {
    "description": "The byte array of the signature in the format specified by Format.",
    "type": "Array",
    "items": {
      "type": "byte"
    },
    "required": false
  },
  "format": {
    "description": "The format of the signature.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "statusCode": {
    "description": "Indicates why a signature is or is not present.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "SignatureRequired",
        "SignaturePresent",
        "SignatureRequiredCancelledByCardholder",
        "SignatureRequiredNotSupportedByPinPad",
        "SignatureRequiredPinPadError",
        "SignatureNotRequiredByThresholdAmount",
        "SignatureNotRequiredByPaymentType",
        "SignatureNotRequiredByTransactionType",
        "SignatureRequiredButPromptSuppressedByMerchant"
      ]
    },
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
POST
/api/v1/reversal/{transactionId}/{paymentType} Creates a new full reversal based on given transaction ID, payment type, and the passed in amounts

Parameters

Parameter Parameter Type Data Type Description
paymentType path string The original payment type.
transactionId path string The ID of a previous transaction.
type query string The type of reversal.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
ReversalRequest body POST_ReversalRequest/v1/reversal/{transactionId}/{paymentType} undefined

Request Class

ReversalRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "configuration": {
    "marketCode": "string"
  },
  "convenienceFeeAmount": "double",
  "referenceNumber": "string",
  "shiftId": "string",
  "ticketNumber": "string",
  "type": "string"
}
TransactionIdRequestConfiguration 
{
  "marketCode": "string"
}
ReversalRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
transactionAmount true double The original transaction amount.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
configuration false POST_TransactionIdRequestConfiguration/v1/reversal/{transactionId}/{paymentType} Any value included in this section will override the corresponding value set in the triPOS.config
convenienceFeeAmount false double The convenience fee amount.
referenceNumber false string A user defined reference number.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
type false string The type of reversal.
TransactionIdRequestConfiguration
Field Required Data Type Description
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
ReversalRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The original transaction amount. ",
    "type": "double",
    "required": true
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_TransactionIdRequestConfiguration/v1/reversal/{transactionId}/{paymentType}",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount.",
    "type": "double",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  },
  "type": {
    "description": "The type of reversal.",
    "type": "string",
    "required": false
  }
}
TransactionIdRequestConfiguration 
{
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  }
}

Response Class

ReversalResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "cardLogo": "string",
  "convenienceFeeAmount": "double",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentType": "string",
  "statusCode": "string",
  "terminalId": "string",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
ReversalResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other
convenienceFeeAmount false double The convenience fee amount.
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentType false string Original card payment type: Credit, Debit, Gift, EBT
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
ReversalResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other",
    "type": "string",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount.",
    "type": "double",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentType": {
    "description": "Original card payment type: Credit, Debit, Gift, EBT",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
POST
/api/v1/sale Creates a new card sale based on the passed in amounts.

Parameters

Parameter Parameter Type Data Type Description
action query string The action to perform with the sale. This can either be 'store' or 'forward'. More information on Store and Forward here.
requestIdToForward query string The request ID of the stored transaction to forward.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
SaleRequest body POST_SaleRequest/v1/sale undefined

Request Class

SaleRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "commercialCardCustomerCode": "string",
  "configuration": {
    "allowDebit": "boolean",
    "allowPartialApprovals": "boolean",
    "cashbackOptions": {
      "manualEntry": {
        "amountIncrement": "int",
        "maximumAmount": "int"
      },
      "selectionAmounts": "string"
    },
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string",
    "promptForSignature": "string",
    "thresholdAmount": "double",
    "tipOptions": {
      "otherOption": "string",
      "tipSelections": "string",
      "type": "string"
    }
  },
  "convenienceFeeAmount": "double",
  "healthcare": {
    "clinic": "double",
    "dental": "double",
    "prescription": "double",
    "total": "double",
    "vision": "double"
  },
  "lodging": {
    "agreementNumber": "string",
    "chargeType": "string",
    "checkInDate": "string",
    "checkOutDate": "string",
    "customerName": "string",
    "duration": "int",
    "extraChargesDetail": "Array<POST_LodgingExtraChargesDetail/v1/sale>",
    "noShow": "boolean",
    "prestigiousPropertyCode": "string",
    "roomAmount": "double",
    "specialProgramCode": "string"
  },
  "referenceNumber": "string",
  "salesTaxAmount": "double",
  "shiftId": "string",
  "ticketNumber": "string",
  "tipAmount": "double"
}
SaleRequestConfiguration 
{
  "allowDebit": "boolean",
  "allowPartialApprovals": "boolean",
  "cashbackOptions": {
    "manualEntry": {
      "amountIncrement": "int",
      "maximumAmount": "int"
    },
    "selectionAmounts": "string"
  },
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string",
  "promptForSignature": "string",
  "thresholdAmount": "double",
  "tipOptions": {
    "otherOption": "string",
    "tipSelections": "string",
    "type": "string"
  }
}
SaleRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
address false POST_Address/v1/sale The cardholder address information for the transaction.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
commercialCardCustomerCode false string The commercial card customer code for the transaction. This is for Level II.
configuration false POST_SaleRequestConfiguration/v1/sale Any value included in this section will override the corresponding value set in the triPOS.config
convenienceFeeAmount false double The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged. more»
healthcare false POST_Healthcare/v1/sale The healthcare section that contains all applicable healthcare-qualified amounts. more»
lodging false POST_LodgingTransactionCompletion/v1/sale The lodging parameters to be passed in for a lodging transaction. more»
referenceNumber false string A user defined reference number.
salesTaxAmount false double The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
tipAmount false double The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
SaleRequestConfiguration
Field Required Data Type Description
allowDebit false boolean Use this parameter to allow debit more».
allowPartialApprovals false boolean If set to true, partial approvals are allowed
cashbackOptions false POST_CashbackOptions/v1/sale Use this section to specify cashback options for each request more».
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
promptForSignature false string Specifies how the signature prompt should be handled for the request. If a value is not provided, UseThreshold will be used. See Signature Prompt.
Values:
  • Always
  • Never
  • UseThreshold
  • None
thresholdAmount false double Specifies the threshold value to use. If included, will override the value in the triPOS.config when promptForSignature is UseThreshold. See Signature Prompt.
tipOptions false POST_TipOptions/v1/sale If these tip options are sent in, they will override the tip options that are currently set in the triPOS.config. To disable tip, send this section up with empty values. To use the values from the triPOS.config, do not include this section in your request more».
CashbackOptions
Field Required Data Type Description
manualEntry false POST_CashbackManualEntry/v1/sale Configurable settings for allowing a cashback choice through manual entry.
selectionAmounts false string The cashback amounts to display on the PIN pad's selection buttons (i.e. 5,10,20,50).
CashbackManualEntry
Field Required Data Type Description
amountIncrement false int The PIN pad will only accept a cashback amount in the provided increment (i.e. Set to 5 to only allow cashback amounts in increments of $5.00).
maximumAmount false int The PIN pad will only accept a cashback amount that does not exceed the provided maximum.
TipOptions
Field Required Data Type Description
otherOption false string Other option to show to select tip.
Values:
  • Other
  • None
tipSelections false string CSV tip amount selections.
type false string Tip numeric type. amount or percentage
Values:
  • Amount
  • Percentage
Healthcare
Field Required Data Type Description
clinic false double The total amount of healthcare-qualified goods that fall into the category of 'clinic'.
dental false double The total amount of healthcare-qualified goods that fall into the category of 'dental'.
prescription false double The total amount of healthcare-qualified goods that fall into the category of 'prescription'.
total false double The total amount of healthcare-qualified goods. If any healthcare values are included, this value is required to be present.
vision false double The total amount of healthcare-qualified goods that fall into the category of 'vision'.
LodgingTransactionCompletion
Field Required Data Type Description
agreementNumber false string The lodging agreement number.
chargeType false string The lodging charge type. For an empty or invalid value, this parameter defaults to Default.
Values:
  • Default
  • Restaurant
  • GiftShop
checkInDate false string The check-in date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.
checkOutDate false string The check-out date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.
customerName false string The lodging customer name.
duration false int The number of hotel stay days. Set to 1 for no show.
extraChargesDetail false Array<POST_LodgingExtraChargesDetail/v1/sale> Pass in up to 6 values that describe the extra charges. For an empty or invalid value, this parameter defaults to NotUsed.
Values:
  • NotUsed
  • Reserved
  • Restaurant
  • GiftShop
  • MiniBar
  • Telephone
  • Other
  • Laundry
noShow false boolean Set to true to indicate no show. Otherwise, value defaults to false.
prestigiousPropertyCode false string The lodging prestigious property code. For an empty or invalid value, this parameter defaults to NonParticipant.
Values:
  • NonParticipant
  • FiveHundredDollarLimit
  • OneThousandDollarLimit
  • OneThousandFiveHundredDollarLimit
roomAmount false double The nightly rate for one room.
specialProgramCode false string The lodging special program code. For an empty or invalid value, this parameter defaults to Default.
Values:
  • Default
  • Sale
  • NoShow
  • AdvanceDeposit
SaleRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/sale",
    "required": false
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "commercialCardCustomerCode": {
    "description": "The commercial card customer code for the transaction. This is for Level II.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_SaleRequestConfiguration/v1/sale",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged. <a href='../help/kb/convenienceFeeAmount.html'>more&raquo;</a>",
    "type": "double",
    "required": false
  },
  "healthcare": {
    "description": "The healthcare section that contains all applicable healthcare-qualified amounts. <a href='../help/kb/healthcare.html'>more&raquo;</a>",
    "type": "POST_Healthcare/v1/sale",
    "required": false
  },
  "lodging": {
    "description": "The lodging parameters to be passed in for a lodging transaction. <a href='../help/kb/lodging.html'>more&raquo;</a>",
    "type": "POST_LodgingTransactionCompletion/v1/sale",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "salesTaxAmount": {
    "description": "The amount of sales tax for the transaction. This is for Level II, submit amount for tax or 0.00 for tax-exempt.",
    "type": "double",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.",
    "type": "double",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}
SaleRequestConfiguration 
{
  "allowDebit": {
    "description": "Use this parameter to allow debit <a href='../help/kb/allowDebit.html'>more&raquo;</a>.",
    "type": "boolean",
    "required": false
  },
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "cashbackOptions": {
    "description": "Use this section to specify cashback options for each request <a href='../help/kb/cashbackOptions.html'>more&raquo;</a>.",
    "type": "POST_CashbackOptions/v1/sale",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  },
  "promptForSignature": {
    "description": "Specifies how the signature prompt should be handled for the request. If a value is not provided, UseThreshold will be used. See <a href='../help/kb/signaturePrompt.html'>Signature Prompt</a>.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Always",
        "Never",
        "UseThreshold",
        "None"
      ]
    },
    "required": false
  },
  "thresholdAmount": {
    "description": "Specifies the threshold value to use. If included, will override the value in the triPOS.config when promptForSignature is UseThreshold. See <a href='../help/kb/signaturePrompt.html'>Signature Prompt</a>.",
    "type": "double",
    "required": false
  },
  "tipOptions": {
    "description": "If these tip options are sent in, they will override the tip options that are currently set in the triPOS.config. To disable tip, send this section up with empty values. To use the values from the triPOS.config, do not include this section in your request <a href='../help/kb/tipOptions.html'>more&raquo;</a>.",
    "type": "POST_TipOptions/v1/sale",
    "required": false
  }
}
CashbackOptions 
{
  "manualEntry": {
    "description": "Configurable settings for allowing a cashback choice through manual entry.",
    "type": "POST_CashbackManualEntry/v1/sale",
    "required": false
  },
  "selectionAmounts": {
    "description": "The cashback amounts to display on the PIN pad's selection buttons (i.e. 5,10,20,50).",
    "type": "string",
    "required": false
  }
}
CashbackManualEntry 
{
  "amountIncrement": {
    "description": "The PIN pad will only accept a cashback amount in the provided increment (i.e. Set to 5 to only allow cashback amounts in increments of $5.00).",
    "type": "int",
    "required": false
  },
  "maximumAmount": {
    "description": "The PIN pad will only accept a cashback amount that does not exceed the provided maximum.",
    "type": "int",
    "required": false
  }
}
TipOptions 
{
  "otherOption": {
    "description": "Other option to show to select tip.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Other",
        "None"
      ]
    },
    "required": false
  },
  "tipSelections": {
    "description": "CSV tip amount selections.",
    "type": "string",
    "required": false
  },
  "type": {
    "description": "Tip numeric type. amount or percentage",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Amount",
        "Percentage"
      ]
    },
    "required": false
  }
}
Healthcare 
{
  "clinic": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'clinic'.",
    "type": "double",
    "required": false
  },
  "dental": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'dental'.",
    "type": "double",
    "required": false
  },
  "prescription": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'prescription'.",
    "type": "double",
    "required": false
  },
  "total": {
    "description": "The total amount of healthcare-qualified goods. If any healthcare values are included, this value is required to be present.",
    "type": "double",
    "required": false
  },
  "vision": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'vision'.",
    "type": "double",
    "required": false
  }
}
LodgingTransactionCompletion 
{
  "agreementNumber": {
    "description": "The lodging agreement number.",
    "type": "string",
    "required": false
  },
  "chargeType": {
    "description": "The lodging charge type. For an empty or invalid value, this parameter defaults to Default.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Restaurant",
        "GiftShop"
      ]
    },
    "required": false
  },
  "checkInDate": {
    "description": "The check-in date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.",
    "type": "string",
    "required": false
  },
  "checkOutDate": {
    "description": "The check-out date for the lodging stay. Must be in the ISO 8601 format of YYYY-MM-DD.",
    "type": "string",
    "required": false
  },
  "customerName": {
    "description": "The lodging customer name.",
    "type": "string",
    "required": false
  },
  "duration": {
    "description": "The number of hotel stay days. Set to 1 for no show.",
    "type": "int",
    "required": false
  },
  "extraChargesDetail": {
    "description": "Pass in up to 6 values that describe the extra charges. For an empty or invalid value, this parameter defaults to NotUsed.",
    "type": "Array",
    "items": {
      "type": "POST_LodgingExtraChargesDetail/v1/sale"
    },
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NotUsed",
        "Reserved",
        "Restaurant",
        "GiftShop",
        "MiniBar",
        "Telephone",
        "Other",
        "Laundry"
      ]
    },
    "required": false
  },
  "noShow": {
    "description": "Set to true to indicate no show. Otherwise, value defaults to false.",
    "type": "boolean",
    "required": false
  },
  "prestigiousPropertyCode": {
    "description": "The lodging prestigious property code. For an empty or invalid value, this parameter defaults to NonParticipant.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NonParticipant",
        "FiveHundredDollarLimit",
        "OneThousandDollarLimit",
        "OneThousandFiveHundredDollarLimit"
      ]
    },
    "required": false
  },
  "roomAmount": {
    "description": "The nightly rate for one room.",
    "type": "double",
    "required": false
  },
  "specialProgramCode": {
    "description": "The lodging special program code. For an empty or invalid value, this parameter defaults to Default.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Sale",
        "NoShow",
        "AdvanceDeposit"
      ]
    },
    "required": false
  }
}

Response Class

SaleResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "approvedAmount": "double",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "cashbackAmount": "double",
  "convenienceFeeAmount": "double",
  "currencyCode": "string",
  "debitSurchargeAmount": "double",
  "emv": {
    "applicationIdentifier": "string",
    "applicationLabel": "string",
    "applicationPreferredName": "string",
    "cryptogram": "string",
    "issuerCodeTableIndex": "string",
    "tags": {
      "key": "string",
      "value": "string"
    }
  },
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "fsaCard": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentType": "string",
  "pinVerified": "boolean",
  "signature": {
    "data": "Array<byte>",
    "format": "string",
    "statusCode": "string"
  },
  "statusCode": "string",
  "subTotalAmount": "double",
  "terminalId": "string",
  "tipAmount": "double",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
SaleResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
approvedAmount false double The amount approved by the processor. This is the actual amount that will be charged or credited.
binValue false string The BIN entry that matched the account number.
cardHolderName false string The cardholder name.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
cashbackAmount false double The cashback amount the cardholder wants.
convenienceFeeAmount false double The convenience fee added to the transaction
currencyCode false string The currency code used in the transaction.
Values:
  • None
  • Usd
debitSurchargeAmount false double The surcharge amount that was added to the transaction.
emv false Emv The fields used on the receipt for an EMV transaction. Null if the transaction was not EMV.
entryMode false string Description of how card was entered.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
fsaCard false string Indicates whether the card used was a FSA card.
Note: Maybe = No BIN entry to determine if FSA.
Values:
  • NotApplicable
  • No
  • Yes
  • Maybe
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentType false string Description of payment type utilized.
Values:
  • None
  • Credit
  • Debit
  • Gift
pinVerified false boolean True if the PIN was verified, false if not verified or undetermined.
signature false Signature The signature data.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
subTotalAmount false double The original amount sent for the transaction.
terminalId false string The ID of the terminal used during the transaction
tipAmount false double The tip amount added to the transaction.
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Emv
Field Required Data Type Description
applicationIdentifier false string The Application Identifier also known as the AID. Identifies the application as described in ISO/IEC 7816-5. Printed receipts are required to contain the AID as hexadecimal characters.
applicationLabel false string Mnemonic associated with the AID according to ISO/IEC 7816-5. If the Application Preferred Name is not available or the Issuer code table index is not supported, then the Application Label should be used on the receipt instead of the Application Preferred Name.
applicationPreferredName false string Preferred mnemonic associated with the AID. When the Application Preferred Name is present and the Issuer code table index is supported, then this data element is mandatory on the receipt.
cryptogram false string The EMV cryptogram type and value. It is a preferred best practice to include this data element on the receipt, but is not mandatory. This field contains cryptogram type followed by the cryptogram value.
issuerCodeTableIndex false string Indicates the code table according to ISO/IEC 8859 for displaying the Application Preferred Name.
tags false Array<Tag> A name value collection of additional EMV tags that are required to appear on the receipt.
Tag
Field Required Data Type Description
key false string undefined
value false string undefined
Signature
Field Required Data Type Description
data false Array<byte> The byte array of the signature in the format specified by Format.
format false string The format of the signature.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
statusCode false string Indicates why a signature is or is not present.
Values:
  • Unknown
  • SignatureRequired
  • SignaturePresent
  • SignatureRequiredCancelledByCardholder
  • SignatureRequiredNotSupportedByPinPad
  • SignatureRequiredPinPadError
  • SignatureNotRequiredByThresholdAmount
  • SignatureNotRequiredByPaymentType
  • SignatureNotRequiredByTransactionType
  • SignatureRequiredButPromptSuppressedByMerchant
SaleResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "approvedAmount": {
    "description": "The amount approved by the processor. This is the actual amount that will be charged or credited.",
    "type": "double",
    "required": false
  },
  "binValue": {
    "description": "The BIN entry that matched the account number.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The cardholder name.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "cashbackAmount": {
    "description": "The cashback amount the cardholder wants.",
    "type": "double",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee added to the transaction",
    "type": "double",
    "required": false
  },
  "currencyCode": {
    "description": "The currency code used in the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Usd"
      ]
    },
    "required": false
  },
  "debitSurchargeAmount": {
    "description": "The surcharge amount that was added to the transaction.",
    "type": "double",
    "required": false
  },
  "emv": {
    "description": "The fields used on the receipt for an EMV transaction. Null if the transaction was not EMV.",
    "type": "Emv",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "fsaCard": {
    "description": "Indicates whether the card used was a FSA card.<br />Note: Maybe = No BIN entry to determine if FSA.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "NotApplicable",
        "No",
        "Yes",
        "Maybe"
      ]
    },
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentType": {
    "description": "Description of payment type utilized.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Credit",
        "Debit",
        "Gift"
      ]
    },
    "required": false
  },
  "pinVerified": {
    "description": "True if the PIN was verified, false if not verified or undetermined.",
    "type": "boolean",
    "required": false
  },
  "signature": {
    "description": "The signature data.",
    "type": "Signature",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "subTotalAmount": {
    "description": "The original amount sent for the transaction.",
    "type": "double",
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount added to the transaction.",
    "type": "double",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Emv 
{
  "applicationIdentifier": {
    "description": "The Application Identifier also known as the AID. Identifies the application as described in ISO/IEC 7816-5. Printed receipts are required to contain the AID as hexadecimal characters.",
    "type": "string",
    "required": false
  },
  "applicationLabel": {
    "description": "Mnemonic associated with the AID according to ISO/IEC 7816-5. If the Application Preferred Name is not available or the Issuer code table index is not supported, then the Application Label should be used on the receipt instead of the Application Preferred Name.",
    "type": "string",
    "required": false
  },
  "applicationPreferredName": {
    "description": "Preferred mnemonic associated with the AID. When the Application Preferred Name is present and the Issuer code table index is supported, then this data element is mandatory on the receipt.",
    "type": "string",
    "required": false
  },
  "cryptogram": {
    "description": "The EMV cryptogram type and value. It is a preferred best practice to include this data element on the receipt, but is not mandatory. This field contains cryptogram type followed by the cryptogram value.",
    "type": "string",
    "required": false
  },
  "issuerCodeTableIndex": {
    "description": "Indicates the code table according to ISO/IEC 8859 for displaying the Application Preferred Name.",
    "type": "string",
    "required": false
  },
  "tags": {
    "description": "A name value collection of additional EMV tags that are required to appear on the receipt.",
    "type": "Array",
    "items": {
      "$ref": "Tag"
    },
    "required": false
  }
}
Tag 
{
  "key": {
    "type": "string",
    "required": false
  },
  "value": {
    "type": "string",
    "required": false
  }
}
Signature 
{
  "data": {
    "description": "The byte array of the signature in the format specified by Format.",
    "type": "Array",
    "items": {
      "type": "byte"
    },
    "required": false
  },
  "format": {
    "description": "The format of the signature.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "statusCode": {
    "description": "Indicates why a signature is or is not present.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "SignatureRequired",
        "SignaturePresent",
        "SignatureRequiredCancelledByCardholder",
        "SignatureRequiredNotSupportedByPinPad",
        "SignatureRequiredPinPadError",
        "SignatureNotRequiredByThresholdAmount",
        "SignatureNotRequiredByPaymentType",
        "SignatureNotRequiredByTransactionType",
        "SignatureRequiredButPromptSuppressedByMerchant"
      ]
    },
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if action is forward and if the requestIdToForward is missing or is not a valid GUID.
400 Returned if client sends in all 5 of the healthcare values as positive values.
400 Returned if any healthcare field has a negative value.
400 Returned if healthcare Total field is less than sum of the other healthcare fields.
400 Returned if action is store and the customer swipes a healthcare card.
400 Returned if MarketCode is not HotelLodging but the request includes lodging parameters on a valid lodging request.
400 Returned if the lodging checkInDate or checkOutDate is not in the ISO 8601 format of YYYY-MM-DD on a valid lodging request.
400 Returned if the lodging roomAmount is less than 0.00 on a valid lodging request.
400 Returned if the lodging duration is less than 0 on a valid lodging request.
400 Returned if the cashbackOptions maximumAmount is either not provided, or is not an integer greater than zero.
400 Returned if the cashbackOptions amountIncrement is not an integer greater than zero. If it is not provided, it will default to 1.
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
404 Returned if action is store or forward and if the given requestIdToForward cannot be found in the database.
500 Returned if action is store or forward and if an error occurs while saving the sale to the database.
500 Returned if action is store or forward and if the stored message cannot be deserialized into the original stored object.
500 Returned if action is store or forward and if the stored message content is blank.
500 Returned if action is store or forward and if triPOS is unable to pull the stored record from the database
POST
/api/v1/sale/{paymentAccountId} Creates a new payment account sale based on the passed in amounts

Parameters

Parameter Parameter Type Data Type Description
paymentAccountId path string The payment account ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
PaymentAccountSaleRequest body POST_PaymentAccountSaleRequest/v1/sale/{paymentAccountId} undefined

Request Class

PaymentAccountSaleRequest 
{
  "laneId": "int",
  "transactionAmount": "double",
  "address": {
    "billingAddress1": "string",
    "billingAddress2": "string",
    "billingCity": "string",
    "billingEmail": "string",
    "billingName": "string",
    "billingPhone": "string",
    "billingPostalCode": "string",
    "billingState": "string",
    "shippingAddress1": "string",
    "shippingAddress2": "string",
    "shippingCity": "string",
    "shippingEmail": "string",
    "shippingName": "string",
    "shippingPhone": "string",
    "shippingPostalCode": "string",
    "shippingState": "string"
  },
  "clerkNumber": "string",
  "configuration": {
    "allowPartialApprovals": "boolean",
    "checkForDuplicateTransactions": "boolean",
    "marketCode": "string"
  },
  "convenienceFeeAmount": "double",
  "healthcare": {
    "clinic": "double",
    "dental": "double",
    "prescription": "double",
    "total": "double",
    "vision": "double"
  },
  "referenceNumber": "string",
  "shiftId": "string",
  "ticketNumber": "string",
  "tipAmount": "double"
}
RequestConfiguration 
{
  "allowPartialApprovals": "boolean",
  "checkForDuplicateTransactions": "boolean",
  "marketCode": "string"
}
PaymentAccountSaleRequest
Field Required Data Type Description
laneId true int Specifies which lane to use for the card sale.
transactionAmount true double The total transaction amount. This is the amount of funds to move on the card
address false POST_Address/v1/sale/{paymentAccountId} The cardholder address information for the transaction.
clerkNumber false string An optional clerk number for reference.
configuration false POST_RequestConfiguration/v1/sale/{paymentAccountId} Any value included in this section will override the corresponding value set in the triPOS.config
convenienceFeeAmount false double The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged
healthcare false POST_Healthcare/v1/sale/{paymentAccountId} The healthcare section that contains all applicable healthcare-qualified amounts. more»
referenceNumber false string A user defined reference number.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
tipAmount false double The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.
Address
Field Required Data Type Description
billingAddress1 false string The street address used for billing purposes.
billingAddress2 false string The street address used for billing purposes.
billingCity false string The name of the city used for billing purposes.
billingEmail false string The e-mail address used for billing purposes.
billingName false string The name used for billing purposes.
billingPhone false string The phone number used for billing purposes. The recommended format is (800)555-1212.
billingPostalCode false string The postal code used for billing purposes.
billingState false string The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.
shippingAddress1 false string The street address used for shipping purposes.
shippingAddress2 false string The street address used for shipping purposes.
shippingCity false string The name of the city used for shipping purposes.
shippingEmail false string The e-mail address used for shipping purposes.
shippingName false string The name used for shipping purposes.
shippingPhone false string The phone number used for shipping purposes. The recommended format is (800)555-1212
shippingPostalCode false string The postal code used for shipping purposes.
shippingState false string The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.
RequestConfiguration
Field Required Data Type Description
allowPartialApprovals false boolean If set to true, partial approvals are allowed
checkForDuplicateTransactions false boolean If set to true, enables duplicate checking logic for the transaction at the host.
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
Healthcare
Field Required Data Type Description
clinic false double The total amount of healthcare-qualified goods that fall into the category of 'clinic'.
dental false double The total amount of healthcare-qualified goods that fall into the category of 'dental'.
prescription false double The total amount of healthcare-qualified goods that fall into the category of 'prescription'.
total false double The total amount of healthcare-qualified goods. If any healthcare values are included, this value is required to be present.
vision false double The total amount of healthcare-qualified goods that fall into the category of 'vision'.
PaymentAccountSaleRequest 
{
  "laneId": {
    "description": "Specifies which lane to use for the card sale.",
    "type": "int",
    "required": true
  },
  "transactionAmount": {
    "description": "The total transaction amount. This is the amount of funds to move on the card",
    "type": "double",
    "required": true
  },
  "address": {
    "description": "The cardholder address information for the transaction.",
    "type": "POST_Address/v1/sale/{paymentAccountId}",
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_RequestConfiguration/v1/sale/{paymentAccountId}",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged",
    "type": "double",
    "required": false
  },
  "healthcare": {
    "description": "The healthcare section that contains all applicable healthcare-qualified amounts. <a href='../help/kb/healthcare.html'>more&raquo;</a>",
    "type": "POST_Healthcare/v1/sale/{paymentAccountId}",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount of the transaction. This amount is added to the TotalAmount before the cardholder is charged.",
    "type": "double",
    "required": false
  }
}
Address 
{
  "billingAddress1": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingAddress2": {
    "description": "The street address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingCity": {
    "description": "The name of the city used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingEmail": {
    "description": "The e-mail address used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingName": {
    "description": "The name used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingPhone": {
    "description": "The phone number used for billing purposes. The recommended format is (800)555-1212.",
    "type": "string",
    "required": false
  },
  "billingPostalCode": {
    "description": "The postal code used for billing purposes.",
    "type": "string",
    "required": false
  },
  "billingState": {
    "description": "The name of the state used for billing purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  },
  "shippingAddress1": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingAddress2": {
    "description": "The street address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingCity": {
    "description": "The name of the city used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingEmail": {
    "description": "The e-mail address used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingName": {
    "description": "The name used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingPhone": {
    "description": "The phone number used for shipping purposes. The recommended format is (800)555-1212",
    "type": "string",
    "required": false
  },
  "shippingPostalCode": {
    "description": "The postal code used for shipping purposes.",
    "type": "string",
    "required": false
  },
  "shippingState": {
    "description": "The name of the state used for shipping purposes. This value may be any 2 character state code or the full state name.",
    "type": "string",
    "required": false
  }
}
RequestConfiguration 
{
  "allowPartialApprovals": {
    "description": "If set to true, partial approvals are allowed",
    "type": "boolean",
    "required": false
  },
  "checkForDuplicateTransactions": {
    "description": "If set to true, enables duplicate checking logic for the transaction at the host.",
    "type": "boolean",
    "required": false
  },
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  }
}
Healthcare 
{
  "clinic": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'clinic'.",
    "type": "double",
    "required": false
  },
  "dental": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'dental'.",
    "type": "double",
    "required": false
  },
  "prescription": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'prescription'.",
    "type": "double",
    "required": false
  },
  "total": {
    "description": "The total amount of healthcare-qualified goods. If any healthcare values are included, this value is required to be present.",
    "type": "double",
    "required": false
  },
  "vision": {
    "description": "The total amount of healthcare-qualified goods that fall into the category of 'vision'.",
    "type": "double",
    "required": false
  }
}

Response Class

PaymentAccountSaleResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "approvalNumber": "string",
  "approvedAmount": "double",
  "avsResponseCode": "string",
  "cardLogo": "string",
  "convenienceFeeAmount": "double",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "paymentAccountId": "string",
  "paymentAccountReferenceNumber": "string",
  "referenceNumber": "string",
  "statusCode": "string",
  "subTotalAmount": "double",
  "terminalId": "string",
  "tipAmount": "double",
  "totalAmount": "double",
  "transactionDateTime": "string",
  "transactionId": "string"
}
PaymentAccountSaleResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
approvedAmount false double The amount approved by the processor. This is the actual amount that will be charged or credited.
avsResponseCode false string The AVS response code.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
convenienceFeeAmount false double The convenience fee added to the transaction
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
paymentAccountId false string The payment account ID.
paymentAccountReferenceNumber false string The payment account reference number.
referenceNumber false string The reference number.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
subTotalAmount false double The original amount sent for the transaction.
terminalId false string The ID of the terminal used during the transaction
tipAmount false double The tip amount added to the transaction.
totalAmount false double The total amount of the transaction.
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
PaymentAccountSaleResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "approvedAmount": {
    "description": "The amount approved by the processor. This is the actual amount that will be charged or credited.",
    "type": "double",
    "required": false
  },
  "avsResponseCode": {
    "description": "The AVS response code.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "convenienceFeeAmount": {
    "description": "The convenience fee added to the transaction",
    "type": "double",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "paymentAccountId": {
    "description": "The payment account ID.",
    "type": "string",
    "required": false
  },
  "paymentAccountReferenceNumber": {
    "description": "The payment account reference number.",
    "type": "string",
    "required": false
  },
  "referenceNumber": {
    "description": "The reference number.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "subTotalAmount": {
    "description": "The original amount sent for the transaction.",
    "type": "double",
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "tipAmount": {
    "description": "The tip amount added to the transaction.",
    "type": "double",
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
GET
/api/v1/selection The list of links for the selection endpoints including only lanes with a pinpad capable of selection entry

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

SelectionDiscoveryResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
SelectionDiscoveryResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
SelectionDiscoveryResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/selection/{laneId} Displays the specified selection form

Implementation Notes

Use the selection endpoint to get cardholder selections via the pinpad. See selection documentation for more information.

Parameters

Parameter Parameter Type Data Type Description
laneId path string The lane ID.
form query string The selection form to display. more»
header query string The header text to display to the cardholder. This is only used for the YesNoTextArea or MultiOptionTextArea form.
subHeader query string The subheader text to display to the cardholder. This is only used for the YesNoTextArea or MultiOptionTextArea form.
text query string The text to display to the cardholder. For the MultiOption form, this is the prompt text. For the YesNoTextArea form, this is the text for the text area.
options query string The selection options to provide to the cardholder. Separate each option with a pipe '|' (e.g. options=one|two|three). This is only used with the MultiOption and MultiOptionTextArea forms.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

SelectionResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "selectionIndex": "int"
}
SelectionResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
selectionIndex false int For the YesNoTextArea form, selectionIndex will be 0 when the cardholder selects No and 1 when the cardholder selects Yes. For the MultiOption form, selectionIndex is the zero-based index of the option that the cardholder selected. The first option specified will be considered option 0.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
SelectionResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "selectionIndex": {
    "description": "For the YesNoTextArea form, selectionIndex will be 0 when the cardholder selects No and 1 when the cardholder selects Yes. For the MultiOption form, selectionIndex is the zero-based index of the option that the cardholder selected. The first option specified will be considered option 0.",
    "type": "int",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
400 Returned if either the 'text' or 'options' parameter is empty when the form is 'MultiOption' or if the 'options' parameter is empty when the form is MultiOptionTextArea.
400 Returned if the 'form' parameter is empty or invalid.
500 Returned if the cardholder doesn't respond within the specified amount of time.
GET
/api/v1/signature The list of links for the signature endpoints including only lanes with a pinpad capable of signature entry

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

SignatureResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
SignatureResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
SignatureResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/signature/{laneId} Displays the specified signature form

Implementation Notes

Use the signature endpoint to get a cardholder signature via the pinpad. See signature documentation for more information.

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
header query string The header text to display to the cardholder.
subHeader query string The subheader text to display to the cardholder.
text query string The text to display to the cardholder.
form query string The signature form to display. Options are 'simple' and 'contract'. more »
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetLaneSignatureResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "laneId": "int",
  "signature": {
    "data": "Array<byte>",
    "format": "string",
    "statusCode": "string"
  }
}
GetLaneSignatureResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
laneId false int The lane ID.
signature false Signature Signature data returned from the pinpad.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
Signature
Field Required Data Type Description
data false Array<byte> The byte array of the signature in the format specified by Format.
format false string The format of the signature.
Values:
  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
statusCode false string Indicates why a signature is or is not present.
Values:
  • Unknown
  • SignatureRequired
  • SignaturePresent
  • SignatureRequiredCancelledByCardholder
  • SignatureRequiredNotSupportedByPinPad
  • SignatureRequiredPinPadError
  • SignatureNotRequiredByThresholdAmount
  • SignatureNotRequiredByPaymentType
  • SignatureNotRequiredByTransactionType
  • SignatureRequiredButPromptSuppressedByMerchant
GetLaneSignatureResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "laneId": {
    "description": "The lane ID.",
    "type": "int",
    "required": false
  },
  "signature": {
    "description": "Signature data returned from the pinpad.",
    "type": "Signature",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
Signature 
{
  "data": {
    "description": "The byte array of the signature in the format specified by Format.",
    "type": "Array",
    "items": {
      "type": "byte"
    },
    "required": false
  },
  "format": {
    "description": "The format of the signature.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "PointsLittleEndian",
        "PointsBigEndian",
        "Ascii3Byte"
      ]
    },
    "required": false
  },
  "statusCode": {
    "description": "Indicates why a signature is or is not present.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "SignatureRequired",
        "SignaturePresent",
        "SignatureRequiredCancelledByCardholder",
        "SignatureRequiredNotSupportedByPinPad",
        "SignatureRequiredPinPadError",
        "SignatureNotRequiredByThresholdAmount",
        "SignatureNotRequiredByPaymentType",
        "SignatureNotRequiredByTransactionType",
        "SignatureRequiredButPromptSuppressedByMerchant"
      ]
    },
    "required": false
  }
}
GET
/api/v1/status Return a list of the triPOS status endpoints

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

StatusResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
StatusResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
StatusResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken are not provided in the HTTP request header or in the config file.
GET
/api/v1/status/host Get host status

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

HostStatusResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "hostStatus": "string",
  "merchantId": "string",
  "transactionDateTime": "string"
}
HostStatusResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
hostStatus false string The status of the connection between triPOS and the host.
Values:
  • Online
  • HostUnreachable
  • Offline
merchantId false string The merchant ID.
transactionDateTime false string Transaction date/time in ISO8601 format
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
HostStatusResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "hostStatus": {
    "description": "The status of the connection between triPOS and the host.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Online",
        "HostUnreachable",
        "Offline"
      ]
    },
    "required": false
  },
  "merchantId": {
    "description": "The merchant ID.",
    "type": "string",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/status/lane/{laneId} Returns the current status of the given lane

Parameters

Parameter Parameter Type Data Type Description
laneId path int The lane ID.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

LaneStatusResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "laneStatus": "string"
}
LaneStatusResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
laneStatus false string The status of the lane.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
LaneStatusResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "laneStatus": {
    "description": "The status of the lane.",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/status/triPOS/{echo} Echos the text passed to triPOS. A successful echo indicates that triPOS is running and responding to requests

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

TriPosStatusResponse 
{
  "_type": "string",
  "echo": "string"
}
TriPosStatusResponse
Field Required Data Type Description
_type false string The type of object held in the result.
echo false string Provided text to be echoed back in the response.
TriPosStatusResponse 
{
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "echo": {
    "description": "Provided text to be echoed back in the response.",
    "type": "string",
    "required": false
  }
}
GET
/api/v1/storedtransactions Retrieve all the stored transactions from the database.

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

GetStoredTransactionsResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "storedTransactions": {
    "createdDate": "Date",
    "response": "string",
    "state": "string",
    "totalAmount": "double",
    "tpRequestId": {},
    "transactionId": "string",
    "transactionType": "string"
  }
}
GetStoredTransactionsResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
storedTransactions false Array<StoredTransaction> List of transactions stored in the database
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
StoredTransaction
Field Required Data Type Description
createdDate false Date The date the transaction was stored.
response false string The response from the host after forwarding the transaction.
state false string The state of the transaction.
Values:
  • Stored
  • Processing
  • Processed
  • Error
totalAmount false double The total amount of the transaction.
tpRequestId false Guid The request Id.
transactionId false string transaction Id from the host after forwarding the transaction.
transactionType false string The transaction type.
Values:
  • Unknown
  • NonFinancialCardRead
  • FinancialCardRead
  • Authorization
  • Capture
  • IncrementalAuthorization
  • Sale
  • ForcePost
  • Refund
  • SaleAdjustment
  • RefundAdjustment
  • Reversal
  • PartialReversal
  • SystemReversal
  • CreateToken
  • CreatePaymetricTokenByTransId
  • CreatePaymetricToken
  • UpdateToken
  • DeleteToken
  • BinQuery
  • Echo
  • Activate
  • BalanceInquiry
  • Reload
  • Unload
  • BalanceTransfer
  • Close
  • AuthorizationCompletion
  • Report
  • Void
  • TransactionUpdate
Guid
Field Required Data Type Description
GetStoredTransactionsResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "storedTransactions": {
    "description": "List of transactions stored in the database",
    "type": "Array",
    "items": {
      "$ref": "StoredTransaction"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
StoredTransaction 
{
  "createdDate": {
    "description": "The date the transaction was stored.",
    "type": "Date",
    "required": false
  },
  "response": {
    "description": "The response from the host after forwarding the transaction.",
    "type": "string",
    "required": false
  },
  "state": {
    "description": "The state of the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Stored",
        "Processing",
        "Processed",
        "Error"
      ]
    },
    "required": false
  },
  "totalAmount": {
    "description": "The total amount of the transaction.",
    "type": "double",
    "required": false
  },
  "tpRequestId": {
    "description": "The request Id.",
    "type": "Guid",
    "required": false
  },
  "transactionId": {
    "description": "transaction Id from the host after forwarding the transaction.",
    "type": "string",
    "required": false
  },
  "transactionType": {
    "description": "The transaction type.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "NonFinancialCardRead",
        "FinancialCardRead",
        "Authorization",
        "Capture",
        "IncrementalAuthorization",
        "Sale",
        "ForcePost",
        "Refund",
        "SaleAdjustment",
        "RefundAdjustment",
        "Reversal",
        "PartialReversal",
        "SystemReversal",
        "CreateToken",
        "CreatePaymetricTokenByTransId",
        "CreatePaymetricToken",
        "UpdateToken",
        "DeleteToken",
        "BinQuery",
        "Echo",
        "Activate",
        "BalanceInquiry",
        "Reload",
        "Unload",
        "BalanceTransfer",
        "Close",
        "AuthorizationCompletion",
        "Report",
        "Void",
        "TransactionUpdate"
      ]
    },
    "required": false
  }
}
Guid 
{}
POST
/api/v1/token/paymetric Creates a Paymetric token based on a card swipe

Implementation Notes

This endpoint is for swipe capable paymetric token creation.

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
CreatePaymetricTokenRequest body POST_CreatePaymetricTokenRequest/v1/token/paymetric undefined

Request Class

CreatePaymetricTokenRequest 
{
  "laneId": "int",
  "vaultId": "string"
}
CreatePaymetricTokenRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
vaultId true string The Vault ID with Paymetric.
CreatePaymetricTokenRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "vaultId": {
    "description": "The Vault ID with Paymetric.",
    "type": "string",
    "required": true
  }
}

Response Class

CreatePaymetricTokenResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "isOffline": "boolean",
  "merchantId": "string",
  "tokenId": "string",
  "tokenProvider": "string",
  "transactionDateTime": "string"
}
CreatePaymetricTokenResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
binValue false string The card bin value. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest.
cardHolderName false string The card holder name on the card. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest. If the card is keyed for a CreatePaymetricTokenRequest this value will be empty.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
entryMode false string Description of how card was entered. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The merchant ID used to process the transaction.
tokenId false string The Token ID.
tokenProvider false string The Token Provider.
transactionDateTime false string Transaction date/time in ISO8601 format
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
CreatePaymetricTokenResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The card bin value. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The card holder name on the card. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest. If the card is keyed for a CreatePaymetricTokenRequest this value will be empty.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The merchant ID used to process the transaction.",
    "type": "string",
    "required": false
  },
  "tokenId": {
    "description": "The Token ID.",
    "type": "string",
    "required": false
  },
  "tokenProvider": {
    "description": "The Token Provider.",
    "type": "string",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
500 The token could not be created with the card used.
POST
/api/v1/token/paymetric/{transactionId} Creates a Paymetric token based on a previous transaction ID

Parameters

Parameter Parameter Type Data Type Description
transactionId path string The ID of a previous transaction.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
CreatePaymetricTokenWithTransIdRequest body POST_CreatePaymetricTokenWithTransIdRequest/v1/token/paymetric/{transactionId} undefined

Request Class

CreatePaymetricTokenWithTransIdRequest 
{
  "laneId": "int",
  "vaultId": "string"
}
CreatePaymetricTokenWithTransIdRequest
Field Required Data Type Description
laneId true int The lane ID.
vaultId true string The Vault ID with Paymetric.
CreatePaymetricTokenWithTransIdRequest 
{
  "laneId": {
    "description": "The lane ID.",
    "type": "int",
    "required": true
  },
  "vaultId": {
    "description": "The Vault ID with Paymetric.",
    "type": "string",
    "required": true
  }
}

Response Class

CreatePaymetricTokenResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "binValue": "string",
  "cardHolderName": "string",
  "cardLogo": "string",
  "entryMode": "string",
  "expirationMonth": "string",
  "expirationYear": "string",
  "isOffline": "boolean",
  "merchantId": "string",
  "tokenId": "string",
  "tokenProvider": "string",
  "transactionDateTime": "string"
}
CreatePaymetricTokenResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The card account number.
binValue false string The card bin value. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest.
cardHolderName false string The card holder name on the card. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest. If the card is keyed for a CreatePaymetricTokenRequest this value will be empty.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.
entryMode false string Description of how card was entered. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest.
Values:
  • Unknown
  • Swiped
  • Keyed
  • ContactIcc
  • ContactlessMsd
expirationMonth false string The card's expiration month
expirationYear false string The card's expiration year
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The merchant ID used to process the transaction.
tokenId false string The Token ID.
tokenProvider false string The Token Provider.
transactionDateTime false string Transaction date/time in ISO8601 format
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
CreatePaymetricTokenResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The card account number.",
    "type": "string",
    "required": false
  },
  "binValue": {
    "description": "The card bin value. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest.",
    "type": "string",
    "required": false
  },
  "cardHolderName": {
    "description": "The card holder name on the card. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest. If the card is keyed for a CreatePaymetricTokenRequest this value will be empty.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other.",
    "type": "string",
    "required": false
  },
  "entryMode": {
    "description": "Description of how card was entered. This value is only provided for a CreatePaymetricTokenRequest NOT for a CreatePaymetricTokenWithTransIdRequest.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Swiped",
        "Keyed",
        "ContactIcc",
        "ContactlessMsd"
      ]
    },
    "required": false
  },
  "expirationMonth": {
    "description": "The card's expiration month",
    "type": "string",
    "required": false
  },
  "expirationYear": {
    "description": "The card's expiration year",
    "type": "string",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The merchant ID used to process the transaction.",
    "type": "string",
    "required": false
  },
  "tokenId": {
    "description": "The Token ID.",
    "type": "string",
    "required": false
  },
  "tokenProvider": {
    "description": "The Token Provider.",
    "type": "string",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.
500 The token could not be created with the transaction ID given.
POST
/api/v1/void/{transactionId} Voids the previous transaction with the passed in transaction ID

Parameters

Parameter Parameter Type Data Type Description
transactionId path string The ID of a previous transaction.
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.
VoidRequest body POST_VoidRequest/v1/void/{transactionId} undefined

Request Class

VoidRequest 
{
  "laneId": "int",
  "cardHolderPresentCode": "string",
  "clerkNumber": "string",
  "configuration": {
    "marketCode": "string"
  },
  "referenceNumber": "string",
  "shiftId": "string",
  "ticketNumber": "string"
}
TransactionIdRequestConfiguration 
{
  "marketCode": "string"
}
VoidRequest
Field Required Data Type Description
laneId true int Specifies which lane to use.
cardHolderPresentCode false string Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.
Values:
  • Default
  • Unknown
  • Present
  • NotPresent
  • MailOrder
  • PhoneOrder
  • StandingAuth
  • ECommerce
clerkNumber false string An optional clerk number for reference.
configuration false POST_TransactionIdRequestConfiguration/v1/void/{transactionId} Any value included in this section will override the corresponding value set in the triPOS.config
referenceNumber false string A user defined reference number.
shiftId false string An optional shift id for reference.
ticketNumber false string An optional ticket number.
TransactionIdRequestConfiguration
Field Required Data Type Description
marketCode false string The market code of the transaction.
Values:
  • Default
  • AutoRental
  • DirectMarketing
  • ECommerce
  • FoodRestaurant
  • HotelLodging
  • Petroleum
  • Retail
  • Qsr
VoidRequest 
{
  "laneId": {
    "description": "Specifies which lane to use.",
    "type": "int",
    "required": true
  },
  "cardHolderPresentCode": {
    "description": "Defines whether the cardholder is present at the transaction. This value is optional, but recommended to be set. If this value is not set in the request, it will be automatically set based on the market code.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "Unknown",
        "Present",
        "NotPresent",
        "MailOrder",
        "PhoneOrder",
        "StandingAuth",
        "ECommerce"
      ]
    },
    "required": false
  },
  "clerkNumber": {
    "description": "An optional clerk number for reference.",
    "type": "string",
    "required": false
  },
  "configuration": {
    "description": "Any value included in this section will override the corresponding value set in the triPOS.config",
    "type": "POST_TransactionIdRequestConfiguration/v1/void/{transactionId}",
    "required": false
  },
  "referenceNumber": {
    "description": "A user defined reference number.",
    "type": "string",
    "required": false
  },
  "shiftId": {
    "description": "An optional shift id for reference.",
    "type": "string",
    "required": false
  },
  "ticketNumber": {
    "description": "An optional ticket number.",
    "type": "string",
    "required": false
  }
}
TransactionIdRequestConfiguration 
{
  "marketCode": {
    "description": "The market code of the transaction. ",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Default",
        "AutoRental",
        "DirectMarketing",
        "ECommerce",
        "FoodRestaurant",
        "HotelLodging",
        "Petroleum",
        "Retail",
        "Qsr"
      ]
    },
    "required": false
  }
}

Response Class

VoidResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_processor": {
    "expressResponseCode": "string",
    "expressResponseMessage": "string",
    "hostResponseCode": "string",
    "hostResponseMessage": "string",
    "logs": "Array<string>",
    "processorLogs": "Array<string>",
    "processorRawResponse": "string",
    "processorReferenceNumber": "string",
    "processorRequestFailed": "boolean",
    "processorRequestWasApproved": "boolean",
    "processorResponseCode": "string",
    "processorResponseMessage": "string",
    "rawResponse": "string"
  },
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  },
  "accountNumber": "string",
  "approvalNumber": "string",
  "cardLogo": "string",
  "isApproved": "boolean",
  "isOffline": "boolean",
  "merchantId": "string",
  "statusCode": "string",
  "terminalId": "string",
  "transactionDateTime": "string",
  "transactionId": "string"
}
VoidResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_processor false Processor Response information from the processor.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
accountNumber false string The Account Number returned by the host
approvalNumber false string Approval number from the processor. Depending on card type and processor an approval number might not be returned.
cardLogo false string The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other
isApproved false boolean Set to true if the host approved the transaction.
isOffline false boolean A boolean value indicating whether triPOS is disconnected from the host.
merchantId false string The Merchant used to process the transaction.
statusCode false string The status code for the transaction.
Values:
  • None
  • Success
  • Declined
  • Approved
  • Restart
  • Failed
  • HostError
  • Timeout
  • FailedVerification
  • CardError
  • UnknownCard
  • UnsupportedCard
  • DeviceError
  • Cancelled
  • ChipError
  • PinPadError
  • PinPadTimeout
  • InvalidLane
  • SwipedCardIsChipCapable
  • ApprovedByMerchant
  • ChipReaderError
  • UseChipReader
  • UseMagneticStripe
  • CardRemoved
  • CardBlocked
  • CardNotSupported
  • BadCard
  • CandidateListEmpty
  • IssuerAuthenticationFailed
  • CardDataEncryptionNotEnabled
  • ApprovedExceptCashback
  • ApplicationBlocked
terminalId false string The ID of the terminal used during the transaction
transactionDateTime false string Transaction date/time in ISO8601 format
transactionId false string The transaction ID from the processor
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
Processor
Field Required Data Type Description
expressResponseCode false string The response code received from Express.
expressResponseMessage false string The response message received from Express.
hostResponseCode false string The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
hostResponseMessage false string The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.
logs false Array<string> A list of messages pertaining processing the transaction.
processorLogs false Array<string> [DEPRECATED] Use logs.
processorRawResponse false string [DEPRECATED] Use rawResponse.
processorReferenceNumber false string [DEPRECATED] Use the same reference number passed in the request.
processorRequestFailed false boolean [DEPRECATED] Use top level properties (e.g. hasErrors).
processorRequestWasApproved false boolean [DEPRECATED] Use top level properties (e.g isApproved).
processorResponseCode false string [DEPRECATED] Use expressResponseCode.
Values:
  • Unknown
  • Approved
  • PartialApproval
  • Decline
  • ExpiredCard
  • Duplicate
  • PickUpCard
  • ReferralCallIssuer
  • InvalidData
  • ApprovedExceptCashback
processorResponseMessage false string [DEPRECATED] Use expressResponseMessage.
rawResponse false string The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
VoidResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_processor": {
    "description": "Response information from the processor.",
    "type": "Processor",
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  },
  "accountNumber": {
    "description": "The Account Number returned by the host",
    "type": "string",
    "required": false
  },
  "approvalNumber": {
    "description": "Approval number from the processor. Depending on card type and processor an approval number might not be returned.",
    "type": "string",
    "required": false
  },
  "cardLogo": {
    "description": "The card logo. Possible values are: Visa, Mastercard, Discover, Amex, Diners Club, JCB, Carte Blanche, Other",
    "type": "string",
    "required": false
  },
  "isApproved": {
    "description": "Set to true if the host approved the transaction.",
    "type": "boolean",
    "required": false
  },
  "isOffline": {
    "description": "A boolean value indicating whether triPOS is disconnected from the host.",
    "type": "boolean",
    "required": false
  },
  "merchantId": {
    "description": "The Merchant used to process the transaction.",
    "type": "string",
    "required": false
  },
  "statusCode": {
    "description": "The status code for the transaction.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "None",
        "Success",
        "Declined",
        "Approved",
        "Restart",
        "Failed",
        "HostError",
        "Timeout",
        "FailedVerification",
        "CardError",
        "UnknownCard",
        "UnsupportedCard",
        "DeviceError",
        "Cancelled",
        "ChipError",
        "PinPadError",
        "PinPadTimeout",
        "InvalidLane",
        "SwipedCardIsChipCapable",
        "ApprovedByMerchant",
        "ChipReaderError",
        "UseChipReader",
        "UseMagneticStripe",
        "CardRemoved",
        "CardBlocked",
        "CardNotSupported",
        "BadCard",
        "CandidateListEmpty",
        "IssuerAuthenticationFailed",
        "CardDataEncryptionNotEnabled",
        "ApprovedExceptCashback",
        "ApplicationBlocked"
      ]
    },
    "required": false
  },
  "terminalId": {
    "description": "The ID of the terminal used during the transaction",
    "type": "string",
    "required": false
  },
  "transactionDateTime": {
    "description": "Transaction date/time in ISO8601 format",
    "type": "string",
    "required": false
  },
  "transactionId": {
    "description": "The transaction ID from the processor",
    "type": "string",
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
Processor 
{
  "expressResponseCode": {
    "description": "The response code received from Express.",
    "type": "string",
    "required": false
  },
  "expressResponseMessage": {
    "description": "The response message received from Express.",
    "type": "string",
    "required": false
  },
  "hostResponseCode": {
    "description": "The response code received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "hostResponseMessage": {
    "description": "The response message received from the host via Express. NOTE: This value is only populated if Express send the request to the host.",
    "type": "string",
    "required": false
  },
  "logs": {
    "description": "A list of messages pertaining processing the transaction.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorLogs": {
    "description": "[DEPRECATED] Use logs.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "processorRawResponse": {
    "description": "[DEPRECATED] Use rawResponse.",
    "type": "string",
    "required": false
  },
  "processorReferenceNumber": {
    "description": "[DEPRECATED] Use the same reference number passed in the request.",
    "type": "string",
    "required": false
  },
  "processorRequestFailed": {
    "description": "[DEPRECATED] Use top level properties (e.g. hasErrors).",
    "type": "boolean",
    "required": false
  },
  "processorRequestWasApproved": {
    "description": "[DEPRECATED] Use top level properties (e.g isApproved).",
    "type": "boolean",
    "required": false
  },
  "processorResponseCode": {
    "description": "[DEPRECATED] Use expressResponseCode.",
    "type": "string",
    "allowableValues": {
      "valueType": "LIST",
      "values": [
        "Unknown",
        "Approved",
        "PartialApproval",
        "Decline",
        "ExpiredCard",
        "Duplicate",
        "PickUpCard",
        "ReferralCallIssuer",
        "InvalidData",
        "ApprovedExceptCashback"
      ]
    },
    "required": false
  },
  "processorResponseMessage": {
    "description": "[DEPRECATED] Use expressResponseMessage.",
    "type": "string",
    "required": false
  },
  "rawResponse": {
    "description": "The raw processor response. In the case of Express, this is the raw XML returned by the Express platform.",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}

Error Status Codes

HTTP Status Reason
401 Returned if the AcceptorId, AccountId, AccountToken and TerminalId (config file only) are not provided in the HTTP request header or in the config file.

/api/versions

GET
/api/versions Returns the available versions of the triPOS API

Parameters

Parameter Parameter Type Data Type Description
tp-application-id header string The ID of the business application.
tp-application-name header string The name of the business application.
tp-application-version header string The version of the business application.
tp-authorization header string The authorization header.
tp-express-acceptor-id header string The Express acceptorId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-id header string The Express accountId. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-express-account-token header string The Express accountToken. If all three Express credentials are specified in the request headers, triPOS will use these credentials instead of the credentials in the triPOS.config for that request only.
tp-request-id header string A unique ID for this request. This value should be a UUID or GUID. more»
tp-return-logs header boolean Set to true to have logs populated in the response.

Response Class

ApiVersionsResponse 
{
  "_errors": {
    "developerMessage": "string",
    "errorType": "string",
    "exceptionMessage": "string",
    "exceptionTypeFullName": "string",
    "exceptionTypeShortName": "string",
    "userMessage": "string"
  },
  "_hasErrors": "boolean",
  "_links": {
    "href": "string",
    "method": "string",
    "rel": "string"
  },
  "_logs": "Array<string>",
  "_type": "string",
  "_warnings": {
    "developerMessage": "string",
    "userMessage": "string"
  }
}
ApiVersionsResponse
Field Required Data Type Description
_errors false Array<ApiError> A list of errors that occurred.
_hasErrors false boolean Indicates if there are errors.
_links false Array<ApiLink> A list of resource links
_logs false Array<string> A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
_type false string The type of object held in the result.
_warnings false Array<ApiWarning> A list of warnings that occurred.
ApiError
Field Required Data Type Description
developerMessage false string An error message targeted at the developer of the integrated business application.
errorType false string Code associated with the error if it exists.
exceptionMessage false string The body of the exception message.
exceptionTypeFullName false string The full name of the exception.
exceptionTypeShortName false string The short name of the exception.
userMessage false string An error message targeted at the end user of the integrated business application.
ApiLink
Field Required Data Type Description
href false string A target (a URI)
method false string The HTTP method to access the HREF target
rel false string The relation aka. 'rel' (the name of the link)
ApiWarning
Field Required Data Type Description
developerMessage false string A warning message targeted at the developer of the integrated business application..
userMessage false string A warning message targeted at the end user of the integrated business application.
ApiVersionsResponse 
{
  "_errors": {
    "description": "A list of errors that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiError"
    },
    "required": false
  },
  "_hasErrors": {
    "description": "Indicates if there are errors.",
    "type": "boolean",
    "required": false
  },
  "_links": {
    "description": "A list of resource links",
    "type": "Array",
    "items": {
      "$ref": "ApiLink"
    },
    "required": false
  },
  "_logs": {
    "description": "A list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.",
    "type": "Array",
    "items": {
      "type": "string"
    },
    "required": false
  },
  "_type": {
    "description": "The type of object held in the result.",
    "type": "string",
    "required": false
  },
  "_warnings": {
    "description": "A list of warnings that occurred.",
    "type": "Array",
    "items": {
      "$ref": "ApiWarning"
    },
    "required": false
  }
}
ApiError 
{
  "developerMessage": {
    "description": "An error message targeted at the developer of the integrated business application.",
    "type": "string",
    "required": false
  },
  "errorType": {
    "description": "Code associated with the error if it exists.",
    "type": "string",
    "required": false
  },
  "exceptionMessage": {
    "description": "The body of the exception message.",
    "type": "string",
    "required": false
  },
  "exceptionTypeFullName": {
    "description": "The full name of the exception.",
    "type": "string",
    "required": false
  },
  "exceptionTypeShortName": {
    "description": "The short name of the exception.",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "An error message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}
ApiLink 
{
  "href": {
    "description": "A target (a URI)",
    "type": "string",
    "required": false
  },
  "method": {
    "description": "The HTTP method to access the HREF target",
    "type": "string",
    "required": false
  },
  "rel": {
    "description": "The relation aka. 'rel' (the name of the link)",
    "type": "string",
    "required": false
  }
}
ApiWarning 
{
  "developerMessage": {
    "description": "A warning message targeted at the developer of the integrated business application..",
    "type": "string",
    "required": false
  },
  "userMessage": {
    "description": "A warning message targeted at the end user of the integrated business application.",
    "type": "string",
    "required": false
  }
}