kepa
Device Interaction/printOnTerminal

Print on Terminal

Print a receipt or kitchen ticket on the built-in printer.

POST/v1/device/print
Send a print job to the terminal's built-in thermal printer, where one is available. Each line accepts alignment, bold, and font-size formatting — enough to render a clean receipt or kitchen ticket without a dedicated layout language. Set cutPaper to true if you want the paper cut at the end of the job.

Request body

application/json

linesarrayrequired

Lines to print (1–100).

cutPaperboolean

Cut paper after printing.

Example: true

Response

application/json

successboolean

Print job accepted.

Example: true

commerce-api/openapi.yaml · printOnTerminal

POSTLocal
http://terminal:8443/v1/device/print
Request
curl http://terminal:8443/v1/device/print \
  -H "X-Api-Key: $ATLAS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lines": [{ "text": "Atlas Coffee", "alignment": "CENTER", "bold": true, "fontSize": "LARGE" },{ "text": "================================", "alignment": "CENTER" },{ "text": "Flat White x1         $5.00", "alignment": "LEFT" },{ "text": "TOTAL                 $5.00", "alignment": "LEFT", "bold": true }],"cutPaper": true}'
Response
{ "success": true }