Print Task Callback

Last updated：2026-08-03 09:28:35

Receive print updatesProvide a callback endpoint in your system to receive completion and error updates.

What do I need before starting?

Prepare a connected printer, its ID and key, an accessible image URL and physical print dimensions. Keep the key on your server.

Submission is not completion. Save the returned task ID. Call Start Print only when the device requires a second confirmation.

Task Callbacks: Third-party platforms are required to configure a callback URL within the Open Platform. Subsequently, whenever the status of a print task is updated, the Open Platform will push the task information to this URL in real-time, enabling the third party to perform necessary follow-up processing.

Callback URL

API Endpoint http://XXXX.com/api/callback Customized by a Third Party

Callback Result

| Parameter Name | Data Type | Parameter Value (Example) | Parameter Description | | --- | --- |----| | type | string | printing | Type: printing - Printing in progress; finish - Completed; cancel - Cancelled | | taskid | string | 20000196 | Unique ID assigned to the print task | | printer_id | string | 500001 | ID of the printer assigned to perform the print job | | once | string | 8305 | A random value sent with each request | | time | string | 1646790335 | Timestamp recorded when the request is sent | | sign | string | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | Signature | | order_id | string | 8003A | The order ID within the Client's system; if two orders are merged for printing, the two order IDs are separated by a comma (e.g., 1569885222,1785336685) | | status | string | 1 | Print task status: 1 - Printing in progress; 2 - Print completed; 3 - Print cancelled; 4 - Print failure; 5 - Feeding failure; 6 - Ejection failure; 7 - Return-to-home failure; 8 - Printer not reset; 11 - Insufficient stock (Order cannot be printed; backend refund required); 12 - Stock warning (Stock is at 0; the next order will fail to print due to insufficient stock) 13-print pause 14-print-failure | | msg | string | Print completed | Displays different information based on the task status: 1 - Printing in progress; 2 - Print completed; 3 - Print cancelled; 4 - Print failure |

If you encounter any unresolved issues during the device commissioning process, please contact the Cloud Printing Support Team for troubleshooting assistance and resolution. Contact details are as follows: Phone: 137-5177-4454 (Same number for WeChat) Email: info@ColorPark.cn

A UV Cloud Printing Service Provider with Deeply Integrated Hardware and Software ® RefineColor*