Skip to navigation
Terminal APIReceipt

Print a receipt

Prints or reprints a receipt for a past transaction. Connects a terminal session automatically if none is active. The transaction must belong to the authenticated merchant and be the most recent transaction within its order. The merchant is resolved from trans_id, and the print uses that merchant’s existing terminal session if one is active.

Returns the terminal vendor’s print response, passed through unmodified.

Only Clover Flex and Clover Mini can print. All other terminals return 400 Not supported here. printer: false is a permanent hardware limitation, so check capabilities.printer from List terminals before offering a reprint in your UI.

400 error messages

MessageCause
Field trans_id is requiredMissing or invalid parameter.
Not supportedThe terminal has no printer.
No transaction found for the given trans_idNo matching transaction for this merchant.
No order_id found for the given transactionThe transaction exists but has no order.
trans_id is not for the most recent transaction within this orderThe transaction isn’t the latest in its order.
Terminal is unavailable.The terminal is offline or busy.
Terminal in merchant mode. Launch customer mode and try again.The terminal is in the wrong mode.
Interaction was cancelled.Cancelled at the terminal.

Some terminal vendor errors also return 400 with the vendor’s own message. Match on the messages above, but expect others.

Authentication

AuthorizationBearer

Use a Payments API key as the bearer token: Authorization: Bearer <api_key>. Get a fresh key from Refresh API Keys.

Path parameters

device_idstringRequired

Hardware Serial Number (HSN) of the terminal, provided by your Integration Delivery lead.

Query parameters

midstringOptional

Merchant ID. Required when your bearer token is an ISV token acting on behalf of a merchant. If the mid can't be resolved to an authorized account, the request returns 400.

Request

This endpoint expects an object.
trans_idstringRequired
Transaction to print. Must belong to the authenticated merchant and be the most recent transaction within its order.
delaystringOptional
Delay before printing.
extra_receiptbooleanOptional
Print an additional copy.

Response

Terminal vendor print response, passed through unmodified.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error