Have It Printed

Reviewed Jan 1, 2000.

• tools: 11 tools scanned
• metadata: scanned

No findings.

Tools (11)

• hip_get_service_info

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

• hip_create_job

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

• hip_get_upload_target

  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.

• hip_add_text_document

  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.

• hip_update_job

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

• hip_quote

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

• hip_create_checkout

  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.

• hip_get_checkout_status

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

• hip_prepare_payment

  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. The recipient's address is checked with USPS first: ADDRESS_UNVERIFIED (with a hint) means correct it with hip_update_job, or set address_confirmed if the person confirms it is right as it is.

• hip_complete_payment

  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.

• hip_get_order

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