triPOS REST API

<back to all web services

GetLaneSignatureRequest

The following routes are available for this service:
GET/api/v1/signature/{laneId}Prompts the user to enter a signature on the pinpad and returns the result.
GetLaneSignatureRequest Parameters:
NameParameterData TypeRequiredDescription
LaneIdpathintYesThe lane ID.
GetLaneSignatureResponse Parameters:
NameParameterData TypeRequiredDescription
LaneIdbodyintNoThe lane ID.
SignaturebodySignatureNoSignature data returned from the pinpad.
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.
Signature Parameters:
NameParameterData TypeRequiredDescription
SignatureDatabodybyte[]NoThe byte array of the signature in the format specified by Format.
SignatureFormatbodystringNoThe format of the signature.

Allowable Values

  • PointsLittleEndian
  • PointsBigEndian
  • Ascii3Byte
SignatureStatusCodebodySignatureStatusCodeNoIndicates why a signature is or is not present.

Allowable Values

  • Unknown
  • SignatureRequired
  • SignaturePresent
  • SignatureRequiredCancelledByCardholder
  • SignatureRequiredNotSupportedByPinPad
  • SignatureRequiredPinPadError
  • SignatureNotRequiredByThresholdAmount
  • SignatureNotRequiredByPaymentType
  • SignatureNotRequiredByTransactionType

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/GetLaneSignatureRequest HTTP/1.1 
Host: booking.pufferdayspa.com 
Content-Type: application/json
Content-Length: length

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

{"laneId":0,"signature":{"data":"AA==","format":"String","statusCode":"Unknown"},"_errors":[{"userMessage":"String","developerMessage":"String","errorType":"String","exceptionMessage":"String","exceptionTypeFullName":"String","exceptionTypeShortName":"String"}],"_hasErrors":true,"_links":[],"_logs":["String"],"_type":"String","_warnings":[{"developerMessage":"String","userMessage":"String"}]}