Printcart developer documentation

Start here

• Getting started

  Printcart's REST API lets you create a store, design products and generate print-ready PDFs without using the dashboard. This page shows the three calls that take you from nothing to an authenticated request: create an account, create a store, then call the API with that store's key. Read Authentication next to see which credential to use.

• Authentication

  Printcart's REST API accepts four credential types: a server-side store key, a low-privilege public token for browsers, an account JWT paired with a store, and an account-only JWT. Each endpoint's security block in the API Reference lists which ones it accepts. This page explains which credential to send from a server or browser, and how to rotate one that leaks.

• Conventions

  The Printcart REST API v1 returns a small set of consistent response envelopes, paginates every list with an opaque cursor instead of page numbers, and rate-limits at 1000 requests per minute per credential. This page documents those conventions plus how errors, idempotency and versioning work, so a client written against one endpoint behaves correctly against all of them.

Guides

• Build path: product to print-ready PDF

  Printcart's REST API build path takes a product from nothing to a print-ready PDF in a fixed sequence: create the product, define a printable side with bleed and a safe zone, save a design against it, and generate the file. This guide walks each step, with links to the full schema in the API Reference.

• Webhooks

  Printcart webhooks push an HTTP POST to your callback URL whenever a product, side, design, template or project changes, so an integration does not have to poll the API. This page covers the available topics and events, the exact payload shape, and how to verify the HMAC-SHA256 Signature header before trusting a delivery.

SDKs

• Design Tool SDK

  The Printcart Design Tool SDK embeds the same product designer used throughout Printcart directly inside your own storefront, so a buyer can customize a product without leaving your site. This page covers installing the package from npm, Yarn or a CDN, and the options, methods and events the designer exposes once it is running.

• Uploader SDK

  The Printcart Uploader SDK lets a buyer upload their own print file straight onto a product side, for storefronts that sell print-your-own-art products rather than ones built in the designer. This page covers installing the package from npm, Yarn or a CDN, and the parameters, methods and events the uploader exposes.

AI services

• AI Services

  Printcart's AI Services API offers pay-per-token Background Removal, Preflight and Image Upscale and Auto-fix endpoints you can call directly, outside the dashboard. Each job is billed from your account's token wallet only when it completes, with no fixed fee. This page lists the token cost of each service and how a low-balance wallet responds.

• Studio AI

  Printcart Studio brings the Auto-Headshot engine to the API as pay-per-token Face Crop, Bulk QR card generation and AI Face Matching, aimed at print-on-demand merchants and school, corporate or sports photography studios. This page lists each endpoint, its token cost, and how job polling works for larger batches.

Reference

• API Reference

  Every published endpoint with request and response schemas, generated from the API itself.

Looking for store-owner guides?

Step-by-step setup guides for sellers live in the tutorials, and each platform app has its own page under apps. For setup and custom work from the Printcart team, see services.

Which integration path should I use?

Questions & answers

Where should I start with the Printcart API?

Start with Getting Started: it creates a store and makes your first authenticated call. Authentication covers the four credential types, and the API Reference lists every endpoint's request and response schema once you're calling the API directly.

What is the difference between the REST API and an SDK?

The REST API is a direct HTTP interface to every Printcart resource (products, designs, orders). The Design Tool and Uploader SDKs are JavaScript packages built on top of it that embed a ready-made UI -- the product designer or a file uploader -- in your own storefront, so you do not build that UI yourself.

Can I call AI services like background removal from the API directly?

Yes. The AI Services and Studio AI pages document pay-per-token endpoints for background removal, preflight, image upscaling, face crop, bulk QR and face matching that you can call outside the dashboard, billed from the same account token wallet.

Can you work with a merchant in my country?

Yes. Printcart services are delivered remotely, so we work with merchants in any country. Netbase JSC, the company behind Printcart, has worked with clients in 80+ countries.

Do you support my industry?

Printcart services are not tied to one industry. Full stores, custom development, integration and support are delivered remotely; tell us what you sell and we will say plainly whether Printcart fits.

How do I pay securely?

You sign the contract with and pay the company, Netbase JSC. App plans are billed through Shopify or Wix for stores on those platforms, and through PayPal for WooCommerce and direct stores. Full-store orders on solution.printcart.com check out through PayPal. Service work is quoted in writing in your Helpdesk ticket before any payment.

Who do I talk to?

Talk to our CEO, Huy Nguyen (David), on WhatsApp at https://wa.me/84937869689 or by email at support@printcart.com.