triPOS REST API

CardRequest

The following routes are available for this service:
GET	/api/v1/pinpad/card/{laneId}	Get card info

**CardRequest** Parameters:
Name	Parameter	Data Type	Required	Description
LaneId	path	int	Yes	The lane ID.

**CardResponse** Parameters:
Name	Parameter	Data Type	Required	Description
CardType	body	CardType	No	Indidcates whether the card read was a financial or non-financial card.
FinancialCard	body	FinancialCard	No	Fields for a financial card response. These fields are populated if the card read was a financial card.
NonFinancialCard	body	NonFinancialCard	No	Fields for a non-financial card response. These fields are populated if the card read was a non-financial card.

**ApiResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Errors	body	List<ApiError>	No	A list of errors that occurred.
HasErrors	body	bool	No	Indicates if there are errors.
Links	body	IEnumerable<ApiLink>	No	A list of resource links
Logs	body	List<string>	No	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	body	string	No	The type of object held in the result.
Warnings	body	List<ApiWarning>	No	A list of warnings that occurred.

**FinancialCard** Parameters:
Name	Parameter	Data Type	Required	Description
AccountNumber	body	string	No	The card account number.
BinValue	body	string	No	The BIN entry that matched the account number.
ExpirationYear	body	string	No	The card's expiration year
ExpirationMonth	body	string	No	The card's expiration month

**NonFinancialCard** Parameters:
Name	Parameter	Data Type	Required	Description
Track1	body	string	No	Track 1 of the non-financial card
Track2	body	string	No	Track 2 of the non-financial card

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /xml/reply/CardRequest HTTP/1.1 
Host: booking.pufferdayspa.com 
Content-Type: application/xml
Content-Length: length

<cardRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://tripos.vantiv.com/2014/09/TriPos.Api">
  <laneId>0</laneId>
</cardRequest>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<cardResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://tripos.vantiv.com/2014/09/TriPos.Api">
  <_errors>
    <error>
      <developerMessage>String</developerMessage>
      <errorType>String</errorType>
      <exceptionMessage>String</exceptionMessage>
      <exceptionTypeFullName>String</exceptionTypeFullName>
      <exceptionTypeShortName>String</exceptionTypeShortName>
      <userMessage>String</userMessage>
    </error>
  </_errors>
  <_hasErrors>true</_hasErrors>
  <_links>
    <link>
      <href>/api/v1/pinpad/card</href>
      <method>GET</method>
      <rel>card</rel>
    </link>
  </_links>
  <_logs xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </_logs>
  <_type>String</_type>
  <_warnings>
    <warning>
      <developerMessage>String</developerMessage>
      <userMessage>String</userMessage>
    </warning>
  </_warnings>
  <cardType>Unknown</cardType>
  <financialCard>
    <accountNumber>String</accountNumber>
    <binValue>String</binValue>
    <expirationMonth>String</expirationMonth>
    <expirationYear>String</expirationYear>
  </financialCard>
  <nonFinancialCard>
    <track1>String</track1>
    <track2>String</track2>
  </nonFinancialCard>
</cardResponse>