triPOS REST API

<back to all web services

CardDiscoveryRequest

The following routes are available for this service:
GET/api/v1/pinpad/cardReturn a list of the triPOS Card endpoints
CardResponse Parameters:
NameParameterData TypeRequiredDescription
CardTypebodyCardTypeNoIndidcates whether the card read was a financial or non-financial card.
FinancialCardbodyFinancialCardNoFields for a financial card response. These fields are populated if the card read was a financial card.
NonFinancialCardbodyNonFinancialCardNoFields for a non-financial card response. These fields are populated if the card read was a non-financial card.
ApiResponse Parameters:
NameParameterData TypeRequiredDescription
ErrorsbodyList<ApiError>NoA list of errors that occurred.
HasErrorsbodyboolNoIndicates if there are errors.
LinksbodyIEnumerable<ApiLink>NoA list of resource links
LogsbodyList<string>NoA list of log entries detailing what happened during the request. Ideally only used during development or troubleshooting as this can be quite verbose.
TypebodystringNoThe type of object held in the result.
WarningsbodyList<ApiWarning>NoA list of warnings that occurred.
FinancialCard Parameters:
NameParameterData TypeRequiredDescription
AccountNumberbodystringNoThe card account number.
BinValuebodystringNoThe BIN entry that matched the account number.
ExpirationYearbodystringNoThe card's expiration year
ExpirationMonthbodystringNoThe card's expiration month
NonFinancialCard Parameters:
NameParameterData TypeRequiredDescription
Track1bodystringNoTrack 1 of the non-financial card
Track2bodystringNoTrack 2 of the non-financial card

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

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

{}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"cardType":"Unknown","financialCard":{"accountNumber":"String","binValue":"String","expirationYear":"String","expirationMonth":"String"},"nonFinancialCard":{"track1":"String","track2":"String"},"_errors":[{"userMessage":"String","developerMessage":"String","errorType":"String","exceptionMessage":"String","exceptionTypeFullName":"String","exceptionTypeShortName":"String"}],"_hasErrors":true,"_links":[{"href":"/api/v1/pinpad/card","method":"GET","rel":"card"}],"_logs":["String"],"_type":"String","_warnings":[{"developerMessage":"String","userMessage":"String"}]}