Getting customer confirmation
If a merchant requires the customer to acknowledge a question before completing a transaction, use the /v1/device/read-confirmation
endpoint.
NOTE
If you need the customer to input data in response to a question, use the
/v1/device/read-input
endpoint.
Prerequisites
- The POS is connected to the device using a network or cloud connection.
- The Clover device is in an idle state, that is, no payment is being taken.
Steps
If the customer can provide a yes or no response, use the device to ask your question:
- Construct a request with
text
set to your question. You can also customize theacceptText
andrejectText
.
{
"text": "Do you want to donate to the fundraiser?",
"acceptText": "Yes, please",
"rejectText": "No thanks"
}
- Send a POST request to the
/v1/device/read-confirmation
endpoint. - Required. Include the required headers for your request.
The text displays on the device. When the customer taps one of the following, a message appears.
* Accept, theresponse
value istrue
.
* Reject, theresponse
value isfalse
.


{
"response": true
}
To display the default idle screen, see Displaying the welcome screen for instructions .
Updated 6 months ago