👍

For more information about REST Pay Display API or the Clover Connect partner program, contact a Clover Connect specialist.

You can use the following list of contents or the side navigation to view available information for REST Pay Display APIs.

Before you begin

• REST Pay Display API overview
• Getting started using REST Pay Display API
  • Creating a sandbox app
  • Obtaining an OAuth token
  • Using Postman with the REST Pay Display API
• Device Connection Options
  • Configuring a cloud connection
  • Configuring a local connection
• Security
• REST Pay Display architecture

Workflows and best practices

• Transaction types
• REST Pay Display 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 codes and errors references

API tutorials

• Required request data

Device tutorials

• Verifying connectivity
• Displaying a message to the customer
• Displaying the welcome screen
• Displaying 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 payment with tip 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 Display flows (US)
• Testing REST Pay Display flows (Canada)

API references

Card endpoints

• Read a card's track data using a Clover device
• Create a card token to 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 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