Have It Printed

What Have It Printed does, what it costs, what file types and sizes are accepted, and how mailing works. Needs a Bearer API key, like every tools/call (POST /v1/onboard to get one).

無需輸入參數。

Start a print-and-mail job. Returns an opaque job_handle used by every later call. Creates nothing chargeable.

無需輸入參數。

Get a short-lived upload URL for the customer's document. PUT the bytes to it. File type and size limits are the same as the website.

Add a letter or document whose text you wrote with the person. Have It Printed typesets it on US Letter paper in a clean serif font, in black and white, and counts its pages. Plain text only: separate paragraphs with a blank line; no images, tables or formatting. Call once per document.

Set the documents, print options and US mailing recipient on a job. Price fields are rejected: the server computes all amounts.

Exact price for the job, computed by the same pricing the website checkout uses. Tax, if any, is added by Stripe at payment.

Create a Stripe Checkout session for the job and return its URL. This does NOT take payment: the customer completes payment at that URL. Show them the quote first.

Whether the customer has paid yet. Payment truth comes from the order record Stripe's webhook creates, never from a browser redirect.

Resolve the EXACT amount HIP will charge, before any payment authorization is obtained or spent. This does NOT charge anything. Returns subtotal_cents, tax_cents, total_cents, currency, a pricing fingerprint and the authorization types HIP accepts. Tax is calculated by Stripe from the destination, so hip_quote alone is not the payable amount. The returned total is bound to this job's documents, options and recipient: change any of them and payment is refused with QUOTE_STALE until you prepare again. Use this when paying autonomously with a delegated payment authorization; a human paying in a browser does not need it. Commits the job to the autonomous payment rail.

Pay for the job with a delegated payment authorization, with no browser and no human step. payment_authorization must be a Stripe shared payment token (spt_...) granted to Have It Printed whose maximum is at least the total from hip_prepare_payment; HIP charges exactly that total and never more. NEVER send a card number, expiry, CVV or any reusable credential to this tool. If the cardholder's bank requires authentication, this returns payment_status=requires_user_action rather than bypassing it.

Status and tracking number for the paid order belonging to this job.