Print - Kushki Developer Portal

The Print API lets your POS system send print jobs to the thermal printer on a Kushki SmartPOS terminal in Chile 🇨🇱. Printing is asynchronous — the API returns immediately with a job ID, and the result is delivered via webhook or status polling.

Beta — Early Access

This API is in early access. Endpoints, parameters, and response structures may change without prior notice. Do not deploy to production without coordinating with the Kushki integration team.

How it works

Create a print job

Send a commands array with the content to print. The terminal queues the job and returns 202 Accepted with a print_job_id.

Receive the result

The final status (COMPLETED or FAILED) is delivered in one of two ways:

Webhook push — supply webhookUrl in the request; Kushki POSTs the result when printing finishes.

Status polling — call the status endpoint with the print_job_id.

Create a print job

Cloud: POST /terminal/v1/{terminalSerial}/sync/print/job
Local: POST /terminal/v1/print

{
  "webhookUrl": "https://yoursite.com/print/notify",
  "commands": [
    {
      "type": "IMAGE",
      "src": "data:image/png;base64,iVBORw0KGgo...",
      "align": "CENTER",
      "width": 200
    },
    {
      "type": "TEXT",
      "text": "MI COMERCIO CHILE",
      "align": "CENTER",
      "size": 32,
      "bold": true
    },
    {
      "type": "DIVIDER",
      "style": "SOLID"
    },
    {
      "type": "COLUMNS",
      "columns": [
        {"text": "Producto Premium", "width": 3},
        {"text": "10.000", "width": 1, "align": "RIGHT"}
      ]
    },
    {
      "type": "DIVIDER",
      "style": "DOTTED"
    },
    {
      "type": "COLUMNS",
      "columns": [
        {"text": "TOTAL", "width": 3, "bold": true},
        {"text": "10.000", "width": 1, "align": "RIGHT", "bold": true}
      ]
    },
    {
      "type": "FEED",
      "lines": 2
    },
    {
      "type": "QR",
      "data": "https://yoursite.com/receipt/12345",
      "size": 6
    },
    {
      "type": "CUT"
    }
  ]
}

Response:

{
  "print_job_id": "pj_a1b2c3d4e5f6",
  "status": "PENDING"
}

Get print job status

Cloud: POST /terminal/v1/{terminalSerial}/sync/print/job_status
Local: GET /terminal/v1/print_job?print_job_id={id}

{
  "print_job_status": "COMPLETED",
  "print_job_id": "pj_a1b2c3d4e5f6"
}

Status	Description
`PENDING`	Job queued — not yet printed
`COMPLETED`	Job printed successfully
`FAILED`	Printing failed (paper jam, out of paper, etc.)

Webhook notification (Local mode only)

In Local Network mode, supply a webhookUrl to receive the result when printing finishes. The terminal POSTs to your URL:

{
  "print_job_id": "pj_a1b2c3d4e5f6",
  "print_job_status": "COMPLETED"
}

Command types

Each object in the commands array must include a type field. All type values must be sent in UPPERCASE.

`type`	Description
`TEXT`	Text line with size, alignment, bold, italic, underline
`COLUMNS`	Multi-column row with proportional widths — ideal for item/price lines
`DIVIDER`	Full-width separator: `SOLID`, `DOTTED`, or `EMPTY`
`FEED`	Advance paper N blank lines
`SPACE`	Insert precise pixel-level vertical whitespace
`CUT`	Trigger the auto-cutter (silently ignored on cutterless terminals)
`IMAGE`	Print a Base64-encoded PNG/JPG — typically used for logos
`QR`	Generate a QR code natively in printer hardware
`BARCODE`	Generate a CODE128 barcode natively in printer hardware

`TEXT` parameters

Parameter	Type	Required	Default	Description
`text`	string	✅	—	Text to print. Append `\n` for explicit line break
`align`	`LEFT` \| `CENTER` \| `RIGHT`	—	`LEFT`	Horizontal alignment
`size`	integer	—	`24`	Font size in px — `24` normal · `32` subtitle · `48` title
`bold`	boolean	—	`false`	Bold text
`italic`	boolean	—	`false`	Italic text
`underline`	boolean	—	`false`	Underline text

`COLUMNS` parameters

Parameter	Type	Required	Description
`columns`	array	✅	Array of column objects
`columns[].text`	string	✅	Column text
`columns[].width`	integer	✅	Proportional weight (e.g. `3` and `1` = 75% / 25%)
`columns[].align`	`LEFT` \| `CENTER` \| `RIGHT`	—	Column alignment
`columns[].bold`	boolean	—	Bold

`IMAGE` parameters

Parameter	Type	Required	Description
`src`	string	✅	Base64-encoded PNG or JPG (`data:image/png;base64,...`)
`align`	`LEFT` \| `CENTER` \| `RIGHT`	—	Image alignment
`width`	integer	—	Width in pixels

`QR` parameters

Parameter	Type	Required	Description
`data`	string	✅	Data to encode in the QR
`align`	`LEFT` \| `CENTER` \| `RIGHT`	—	Alignment
`size`	integer	—	QR module size (1–8)

`BARCODE` parameters

Parameter	Type	Required	Description
`data`	string	✅	Data to encode (CODE128)
`align`	`LEFT` \| `CENTER` \| `RIGHT`	—	Alignment
`width`	integer	—	Barcode width in pixels
`height`	integer	—	Barcode height in pixels

Base URLs

☁️ Cloud — Production

☁️ Cloud — UAT

🏠 Local Network

https://cloudt.kushkipagos.com/terminal/v1/{terminalSerial}/sync

Available Endpoints

Create Print Job (Cloud)

Queue a print job via cloud. Returns 202 immediately; result via webhook or polling.

Create Print Job (Local)

Queue a print job over local network. Supports webhook notification.

Get Print Job Status (Cloud)

Poll the status of a queued print job via cloud.

Get Print Job Status (Local)

Poll the status of a queued print job over local network.

Print Job Webhook (Local)

Inbound webhook endpoint — implement this in your POS to receive print job completion events.

Got a suggestion on this documentation? Contact us.

Local Print Services

How it works#

Create a print job#

Get print job status#

Webhook notification (Local mode only)#

Command types#

TEXT parameters#

COLUMNS parameters#

IMAGE parameters#

QR parameters#

BARCODE parameters#

Base URLs#

Available Endpoints#

How it works

Create a print job

Get print job status

Webhook notification (Local mode only)

Command types

`TEXT` parameters

`COLUMNS` parameters

`IMAGE` parameters

`QR` parameters

`BARCODE` parameters

Base URLs

Available Endpoints