Issue a credit

United States

If a merchant needs to refund a customer without tracking the refund against an existing payment, the /v1/credits endpoint method is used. This type of transaction is also referred to as a manual or naked refund. Credits can be for any amount, and the request must include an Idempotency-Key to maintain a record of the credit between the POS and the Clover system. See Track transactions with idempotency keys for more information.


  • POS is connected to the device using a network or cloud connection.
  • Clover device is idle; that is, no payment is being taken.


  1. Construct a request with the required data—the amount of the credit in cents.
  "amount": 2450
  1. Send a POST request to the /v1/credits endpoint.
  2. Required. Include the required headers for your request.
    The credit is processed for the requested amount. After the credit is complete, a success message appears.
  1. Optional. To print a credit receipt, send a POST request to the /v1/credits/{creditId}/receipt endpoint.
  2. To return to the welcome screen, send a POST request to the /v1/device/welcome endpoint.