Have It Printed

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.

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.

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.

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

The options for a postcard or a letter written here: the handwriting-style fonts, the letter types, the stationery designs (with a preview picture each), the postcard sizes and fronts, and the mailing options. Read it before hip_set_postcard or hip_set_letter, and offer the person choices from it; never invent a font, design or front.

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

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

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).

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.

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.

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

Write a letter on a job from hip_create_job, printed in a handwriting-style font, optionally on a stationery design: the letter type, the font, the message, the greeting and sign-off, the name it is signed with, and how it is mailed (flat and tracked, a First-Class letter of up to 5 pages, or a Certified letter). Have It Printed checks it as its website does (fit, names, the design's own words), counts the pages, and returns the price and a preview picture of page 1. Calling it again replaces the letter. Never include an address: the person enters the mailing address at checkout.

Write a postcard on a job from hip_create_job: its size, its front (a front from hip_get_catalog), the message on the back in a handwriting-style font, and the name it is signed with. Have It Printed checks that the message fits the card and follows the card guidelines, and returns the price and preview pictures of both sides. Calling it again replaces the card. Postcards are printed in full color and mailed First-Class with no tracking. Never put a mailing address on the card or in this call: the person enters it at checkout.

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