Print Job Webhook (inbound — implemented by your POS)

POST

/terminal/v1/print/webhook

Implemented by your POS system
This endpoint lives in your infrastructure, not in Kushki ONE.
When a print job completes or fails, the terminal POSTs to the webhookUrl
you supplied in the print job request.
Document it here so your team knows the expected payload shape.

Your webhook endpoint must return HTTP 2xx. No automatic retry is
guaranteed in the current Beta. If the webhook does not arrive within ~60
seconds, use the GET /terminal/v1/print_job polling endpoint as a fallback.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

Webhook received.

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

cURL

Job completed successfullyJob failed — cover open

curl --location 'https://api-uat.kushkipagos.com/terminal/v1/print/webhook' \
--header 'Content-Type: application/json' \
--data '{
    "printJobId": "RECEIPT-20240317-001",
    "status": "COMPLETED",
    "externalReference": "Order-4421"
}'

Modified at 2026-06-02 17:04:53

Get Print Job Status

Release Notes

Print Job Webhook (inbound — implemented by your POS)

Implemented by your POS system#

Request

Responses

Implemented by your POS system