Hoplix Print on Demand

Cancels an order that is not in production yet; if it was already paid from the wallet the amount goes back to the wallet. Orders in production or shipped cannot be cancelled. Also cancels TEST-... orders.

Checks whether a delivery address is complete and the destination country is served by Hoplix. Returns valid true/false with the reason.

Creates a new campaign: the seller's design printed on a catalogue product (plus optional additional products), with selling price and colours. The design is an image uploaded on a personal Hoplix upload page (front_design_upload_id / back_design_upload_id) or a public http(s) URL of a PNG or JPG image (front_image_url / back_image_url). A transparent PNG at the size given in the product "pixel" field gives the best print. A public campaign gets its own page on Hoplix at the chosen url; a private one is only for the seller's own orders. Returns the campaign id.

Places a real order that Hoplix prints and ships, with the same checks and prices as an order quote. Nothing is charged: the order is created unpaid and goes into production only after the seller pays it from the Orders page of the Hoplix account (the payment link is also sent by email), unless the account has agreed billing terms. order_reference is mandatory and unique: an existing reference is never ordered twice. With test=true the order is only validated and recorded as a test (TEST-... id).

Details of one of the seller's campaigns: name, description, URL, status, currency and its products with product-id, price, colours, sizes and preview images. The product-id identifies a campaign product in quotes and orders.

Status of a design upload: waiting_for_upload, uploaded (with file name, type, width and height in pixels) or expired.

Full details of one order: date, your reference, status, shipping cost, tracking and the ordered products. Accepts real order ids and test order ids (TEST-...).

Status, shipping code and tracking URL of an order, looked up by Hoplix order id or by the seller's own order reference (one of the two is required).

Full details of one catalogue product: description, colours, sizes, base costs, production days, printable area, pixels needed for the artwork, weight, and the products that can be added to the same campaign.

Lists the seller's campaigns (a campaign is a design applied to one or more products), newest first, with id, name, URL, status, dates, and products with selling price and colours.

Lists the seller's orders, newest first, with status, shipping code and tracking URL. With test=true it lists only the test orders.

Lists the blank products available on Hoplix (t-shirts, hoodies, mugs, bags, phone cases...) with product code, colours, sizes, base cost in EUR for front print and for front and back print, production days.

Calculates total and shipping cost of an order with the seller's prices and discounts, running the same checks as a real order (campaign products, sizes, colours, quantities, address). Nothing is saved and nothing is charged.

Creates a personal Hoplix upload page for a campaign design and returns its upload_url and a design_upload_id (UPL-...). On that page the user uploads a PNG or JPG image (max 15 MB) from their device; images shared in a chat are not reachable by the server. The link expires in 30 minutes; uploaded images are deleted after 7 days. The design_upload_id is accepted by campaign creation as front or back design.