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:

1. Construct a request with text set to your question. You can also customize the acceptText and rejectText.

 {
  "text": "Do you want to donate to the fundraiser?",
  "acceptText": "Yes, please",
  "rejectText": "No thanks"
}

2. Send a POST request to the /v1/device/read-confirmation endpoint.
3. 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, the response value is true.
   * Reject, the response value is false.

{
  "response": true
}

See Displaying the welcome screen for instructions to display the default idle screen, or take other appropriate action.