Clover REST Pay Display API is currently in beta. You can use the following list of contents or the side nav contents to navigate through the docs.

Getting started

• REST Pay Display overview
• Getting started using REST Pay Display
  • Creating a sandbox app
  • Connection configuration overview
    • Configuring a cloud connection
    • Configuring a local connection
• Security
• REST Pay architecture
• Using Postman with the REST Pay API

Workflows and best practices

• Transaction types
• REST Pay payment flows
• Interoperability with Ecommerce API
• Tracking transactions with idempotency keys
• Payment reconciliation and recovery

Issues and errors

• Handling issues and errors
  • Checking for duplicate payments
  • Handling offline payments
  • Handling partial payments
  • Handling signature issues
• Handling communication issues
• Status code and error reference

API tutorials

• Required request data

Device tutorials

• Verifying connectivity
• Displaying a message to the customer
• Showing the welcome screen
• Showing the thank you screen
• Canceling the current action
• Getting a signature
• Getting customer confirmation
• Getting customer input
• Requesting a tip
• Printing a receipt
• Opening the cash drawer
• Resetting the device

Payment tutorials

• Making a sale
• Authorizing and capturing a tip-adjusted payment on paper
• Authorizing and capturing a tipped payment on screen
• Capturing preauth payments
• Refunding a charge
• Issuing a credit

Card tutorials

• Creating and using a card token
• Getting a customer's card data

App review and approval

• Creating a production app
• Testing REST Pay flows (US)
• Testing REST Pay flows (Canada)

API references

Card endpoints

• Read a card's track data using a Clover device
• Create a card token for use with subsequent payments

Credits endpoints

• Send a credit request to the Clover device
• Get a credit
• Refund a payment
• Void a payment

Device endpoints

• Cancel any in-flight operations
• Retrieve a list of cash drawers
• Open the specified cash drawer
• Display a message
• Verify connectivity
• Get the status of a print job
• Print an image
• Print text
• Retrieve a list of printers
• Get a user confirmation response
• Get a text response
• Get a signature
• Get a tip
• Get the device's status
• Display a thank you screen
• Display the welcome screen
• Reset the device and cancel any in-flight operations

Payments endpoints

• Send a payment request to a Clover device
• Get a payment by externalPaymentId
• Get a payment
• Capture a pre-auth payment
• Increment an authorization (pre-auth)
• Tip adjust a payment

Receipts endpoints

• Display receipt options
• Deliver a credit receipt
• Deliver a payment receipt
• Deliver a refund receipt
• Deliver a void receipt