Answer a Terminal Prompt

An async endpoint used for attempting to answer a pending decision prompt on a terminal. The decisionId & answer is returned by the payRequest in the pendingDecision object, and is required to differentiate prompt messages. There is no result to acknowledge that this decision was received by the terminal.

Request

Security:

JWT

path Parameters

payRequestId

required

string

header Parameters

Authorization required	string Default: Bearer {$$.env.access_token}
Content-Type required	string Value: "application/json"

Request Body schema: application/json

decisionId required	string The corresponding decisionId as provided by the pendingDecision object of the payRequest
answer required	string The exact case-sensitive answer as provided by the list of answers in the pendingDecision object of the payRequest

Responses

202

Accepted

400

When the provided payload is not valid.

403

When you don't have the right permissions to answer a pending decision for the provided payRequest.

412

When the terminal is not paired.

put/pay-terminal/requests/{payRequestId}

Request samples

Payload
curl
C#
Node.js

application/json

{"decisionId": "0f448ac1-862a-4c7b-bdb4-a3b7cdbf6149",
"answer": "YES"
}

Response samples

application/json

{"error": "\"decisionId\" is required",
"errorCode": "VALIDATION_ERROR"
}