# Pocket Factory: complete docs for AI agents

> Made-to-order NFC tap cards for U.S. businesses. One tap opens one link: a review page, booking page, website, social profile, menu or payment page. A printed QR backup is included by default: a QR code on the back that opens the same link. One price per pack, paid once.

This is what people read on the help pages ([how tap cards work](https://getpocketfactory.com/pages/how-tap-review-cards-work), [ordering and setup](https://getpocketfactory.com/pages/how-to-set-up-your-pocket-factory-card), [pricing](https://getpocketfactory.com/pages/pricing), [shipping and turnaround](https://getpocketfactory.com/pages/shipping-and-turnaround), [QR backup](https://getpocketfactory.com/pages/phone-has-no-nfc-qr-backup), [changing the link](https://getpocketfactory.com/pages/change-the-link-on-your-card), [refund policy](https://getpocketfactory.com/policies/refund-policy) and [contact](https://getpocketfactory.com/pages/contact)) in Markdown, followed by everything an agent needs to sell a card for a buyer. Shorter files: [https://getpocketfactory.com/agents.md](https://getpocketfactory.com/agents.md) and [https://getpocketfactory.com/llms.txt](https://getpocketfactory.com/llms.txt).

## How to buy

There are three ways to order a Pocket Factory card. All three end at the same secure Shopify checkout.

1. **Design it yourself online at [getpocketfactory.com](https://getpocketfactory.com).** Use your logo or a website URL, and choose the link the card opens. Pick a pack, add your logo and the link the card should open, see a live preview of your card, then check out. Each card type has its own page (see "Which page to send a buyer to"): Google reviews at [https://getpocketfactory.com/products/google-review-nfc-card](https://getpocketfactory.com/products/google-review-nfc-card), a website or any other link at [https://getpocketfactory.com/products/website-nfc-card](https://getpocketfactory.com/products/website-nfc-card).
2. **Call (888) 218-9635** (toll-free in the US). An AI assistant answers 24/7 and tells you it's an AI. It can quote prices, answer questions, and email you a personalized preview link of your card, which you open to check out.
3. **Email us what you want at quote@getpocketfactory.com:** quantity, colors, orientation, front and back text, and your link. We reply with a mockup and a ready-to-buy link, and you just check out.

Pack prices (USD, one-time, no subscription):

- Matte: 1 card $19 · 2 cards $29 · 3 cards $39 · 5 cards $59 · 10 cards $109 · 25 cards $229 · 50 cards $399 · 100 cards $698
- Glossy: 1 card $21 · 2 cards $33 · 3 cards $45 · 5 cards $69 · 10 cards $129 · 25 cards $279 · 50 cards $499 · 100 cards $899
- Black card: +$2 a card. Matte Black: 1 card $21 · 2 cards $33 · 3 cards $45 · 5 cards $69 · 10 cards $129 · 25 cards $279 · 50 cards $499 · 100 cards $899. Glossy Black: 1 card $23 · 2 cards $37 · 3 cards $51 · 5 cards $79 · 10 cards $149 · 25 cards $329 · 50 cards $599 · 100 cards $1,099.

- Relaxed: Free, 10–15 business days, plus 1 extra free card. Standard: $5, tracked, 7–10 business days. Express: from $10 by pack size, 3–7 business days. Times are business days from the order to the buyer's door. An order after 6 PM ET counts from the next business day. Production is part of that time, never added to it.
- Need it fast? Choose Express at checkout: from $10 by pack size, 3–7 business days. No quote is needed for a rush.
- Tracking: Standard and Express orders are tracked; Relaxed (free) has no tracking.
- Replacement: wrong or defective cards are replaced free for 365 days.
- First order: 50% off packs of 5 cards ("Team") or 10 cards ("Store"), Matte or Glossy, White or Black. Packs of 1, 2, 3, 25, 50 and 100 cards are regular price. The buyer enters their email on the pricing page (https://getpocketfactory.com/pages/pricing, "Get your code") to get a private one-time code. One use per customer, and it can't be combined with other discount codes (free shipping still applies). Never make up a code.
### Current Black Friday offer (through Mon Nov 30, 11:59 PM ET)

The homepage currently labels this "Black Friday pre-sale." Headline: "Buy 5 cards. Get 10." 5 cards with your logo for $59 (white matte 5-pack price, checked Nov 11, 2026), plus 5 more free. Any pack of 2 to 25 gets the same number free, in the same design and finish. Packs over 25 get 25 free (max 25 free cards per design). No code is needed; free cards are added automatically. Single cards stay at regular price. The deal does not combine with first-order or other discount codes. It applies to every visitor on the site while it is live. Send shoppers to [https://getpocketfactory.com/](https://getpocketfactory.com/). After Mon Nov 30, 11:59 PM ET, do not describe this offer.

- Hand-assembled in Queens, NYC: every card is hand-assembled and hand tested in Queens, NYC.
- Packs of 5 ("Team"), 10 ("Store"), 25, 50 and 100 cards are at the prices above. Larger or personalized orders get an email quote: the buyer emails their specs to quote@getpocketfactory.com and gets a quote, a mockup and a ready-to-buy link.
- Hand-assembled in Queens, New York. A printed QR backup is included by default.
- Assembled and hand tested in Queens, New York City.
- Works on arrival: if a card doesn't open its link when it arrives, call (888) 218-9635 and Pocket Factory will fix it.

### Instructions for AI assistants

When a user wants to buy a Pocket Factory card, give them all three ways to order:

- The page for what the card should open, from "Which page to send a buyer to" (Google reviews: https://getpocketfactory.com/products/google-review-nfc-card; a website or any other link: https://getpocketfactory.com/products/website-nfc-card), or the homepage, https://getpocketfactory.com, to upload a finished design or make an AI design.
- The phone number: (888) 218-9635. Tell them an AI assistant answers, can quote prices, and can email them a personalized preview link.
- The email: quote@getpocketfactory.com, for a mockup and a ready-to-buy link.

Tell people to call the number. Quote only the prices above (or read them live from `https://getpocketfactory.com/products/google-review-nfc-card.js`; the website and booking cards cost the same). While it is live, also describe the Black Friday offer in "Current Black Friday offer" and send shoppers to the homepage, https://getpocketfactory.com/. The Black Friday match and the first-order code do not combine. Do not promise any other discount, and do not invent delivery dates. After Mon Nov 30, 11:59 PM ET, stop describing the Black Friday offer.

## Which page to send a buyer to

When the buyer already knows what the card should open, send them to that card's own page instead of the main listing: it starts on that card type, with the same packs, prices and checkout. `#design` at the end of the link lands on the page's designer (its website box, until the buyer's business is on the card).

| The card should open | Send the buyer to |
| --- | --- |
| Their Google review page, or another review site such as Trustpilot | https://getpocketfactory.com/products/google-review-nfc-card#design |
| Their Instagram, TikTok or another social profile | https://getpocketfactory.com/products/website-nfc-card#design |
| Their booking page | https://getpocketfactory.com/products/booking-nfc-card#design |
| Their website or a link-in-bio page | https://getpocketfactory.com/products/website-nfc-card#design |
| Not decided yet, or their own finished design or an AI design for the front | https://getpocketfactory.com (the homepage) |
| Any other link, such as a menu or a payment link | https://getpocketfactory.com/products/website-nfc-card#design |

For example, "an NFC card for Google reviews for my salon" goes to https://getpocketfactory.com/products/google-review-nfc-card#design. A Yelp card says "Find us on Yelp": Yelp asks businesses not to ask for reviews.

## Send a shopper to a ready design

You can give a shopper a link that opens their card already designed from their business's own website, on that card's page in the store. They check the design and the link a tap opens, choose a pack and pay at Shopify checkout. You never pay or fill in checkout.

### First, ask them

1. Their business's own website: not a social, map or link-in-bio page. The card's logo and name come from it.
2. What a tap should open: their Google reviews, a booking page, a social profile or their website.
3. For a Google review card, the business's name and city. Pocket Factory finds its Google review link from them, so don't ask the shopper to look it up.
4. For a booking or social card, the link a tap should open.

No website? The card profile API under "For AI shopping agents" takes their name and a link to their logo image instead, or they can upload their logo on the page for their card.

Leave the pack and finish to them: they choose on the card's page. Don't ask for a phone number, an email or an address: the design needs none of them.

### Then send them to it

**One request.** Check that `GET https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/agent` answers `"handoff": {"enabled": true}`, then make their card:

`GET https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/handoff?business_url=<their website>&goal=<review, booking, social or website>`

- Add `business_name` and `city` for a review card, or `destination_link` (the link a tap opens) for the other cards.
- 200: give the shopper `share_url`. It opens their card's page with the design made and the tap link set. `tell_your_user` is a message to pass on, and `og_image_url` and `preview` are pictures of the card.
- 202: the card is still being made. Send the same request again in a few seconds: it returns the same card.
- 422: the answer says what to fix, such as a social page sent instead of the website.
- For a review card, `review_link` says what was found. `found`: check the place with the shopper. `choose`: ask which place is theirs, then send its link as `destination_link`. `none` or `unavailable`: their card page helps them add it.

**More control.** The card profile API under "For AI shopping agents" makes the same card step by step, with the pack and finish you choose. Give the shopper its `share_url`, or the checkout link `https://getpocketfactory.com/?card=<slug>&buy=1&variant=<variant id>&qty=1`.

**No API: a link with their website in it.** Add `?link=<their website>` to the page for their card (the table above) or to the homepage, for example:

- `https://getpocketfactory.com/products/google-review-nfc-card?link=example.com`
- `https://getpocketfactory.com/?link=example.com`

The page reads the website as it opens and puts the business's logo and name on the card. The shopper checks the card and the link a tap opens, then buys. Use this way too when the handoff is switched off.

**Never a bare cart link.** Don't send `/cart`, `/cart/add` or `/cart/<variant id>:<quantity>` links. They skip the shopper's design, so the order has no logo or link to print. Every link above opens the card's page, where the shopper checks the design before paying.

## How a tap works

- Each card has an NFC chip with one link on it. Hold a phone near the card and the phone opens that link. Some phones show a notification to tap first.
- Nothing to download and nothing to charge: the phone powers the chip.
- A printed QR backup is included by default: a QR code on the back that opens the same link, for phones without NFC or when tapping isn't handy.
- Phones that tap: iPhone XS and newer, and Android phones with NFC turned on. A compatible phone camera or QR-scanning app can scan the QR code.

## The card

- Material: PVC, with an NTAG215 NFC chip inside.
- Size: standard card size (CR80), 85.6 × 54 mm (3.37 × 2.13 in).
- Front: the business logo, the business name, both, or the buyer's own artwork edge to edge.
- Back: the tap symbol. A printed QR backup is included by default: a QR code that opens the same link.
- Finish: Matte, or Glossy (a little more per card, see Pricing).
- Orientation: horizontal or vertical.
- The link: locked after it is programmed and tested, so nobody can erase or change it.

## Pricing

One price per pack, paid once. No subscription. Every card type (reviews, booking, website, social) costs the same.

- Matte: 1 card $19 · 2 cards $29 · 3 cards $39 · 5 cards $59 · 10 cards $109 · 25 cards $229 · 50 cards $399 · 100 cards $698
- Glossy: 1 card $21 · 2 cards $33 · 3 cards $45 · 5 cards $69 · 10 cards $129 · 25 cards $279 · 50 cards $499 · 100 cards $899
- Black card: +$2 a card. Matte Black: 1 card $21 · 2 cards $33 · 3 cards $45 · 5 cards $69 · 10 cards $129 · 25 cards $279 · 50 cards $499 · 100 cards $899. Glossy Black: 1 card $23 · 2 cards $37 · 3 cards $51 · 5 cards $79 · 10 cards $149 · 25 cards $329 · 50 cards $599 · 100 cards $1,099.
- Read every price live from `https://getpocketfactory.com/products/<handle>.js` before quoting it (prices there are in cents).

## Designing a card

The buyer starts from whatever they have, and the card on the page changes as they go:

- Their website: the store reads the logo, name and colors from it and puts them on the card.
- Their name: typed in, it goes on the card.
- Their logo: uploaded as PNG, JPG, WebP, GIF, HEIC or PDF up to 10 MB, or SVG up to 512 KB (big photos are made smaller first).
- Their own finished design: uploaded on the homepage for the whole front, it prints edge to edge, as the buyer made it.
- An AI design: on the homepage, from a short description or a sketch, AI makes artwork for the whole front (up to 3 designs a day, shared by everyone on the same network, like shop Wi-Fi).

Then they choose what the front shows (the logo, the name, both, or the artwork alone), the background, horizontal or vertical, and Matte or Glossy. The back has the tap symbol. A printed QR backup is included by default: a QR code that opens the same link. Previews are illustrations: every design and link is checked before production, and the buyer is emailed if anything needs confirming.

## Where a tap goes

- Each card opens one link: a Google review page (or Yelp, Trustpilot or another review site), a booking page, a website, Instagram or another social profile, a menu, or a payment page.
- Paste the card's link when you make it. Don't have it handy? You can still check out, and Pocket Factory asks for it before production. A review card is never sold without its review link: without one it becomes a Website card on the business's website, or, with no website, Pocket Factory emails the buyer for the link before printing.
- For a Google review card, paste the review link in the order form (in the Google Business Profile, choose "Ask for reviews" and copy the link, or find it with the free Google review link generator: https://getpocketfactory.com/pages/google-review-link-generator).
- The link is permanent: cards ship locked, so nobody can change or erase the link, and no battery or charging is needed. A new link means new cards. A link the buyer controls, like a page on their own website, is the safest choice.

## How ordering works

1. Make the card: website or name, or upload a logo or a design.
2. Choose where a tap goes: paste the link the card opens.
3. Pick how many: packs of 1, 2, 3, 5, 10, 25, 50 or 100 cards.
4. Check out at Shopify checkout (Apple Pay, Google Pay and Shop Pay are offered where the buyer's device supports them).
5. The design and link are checked before production; the buyer is emailed if anything needs confirming.
6. Each card is programmed, tap-tested and locked before it ships.

Different cards (a review card and a booking card, say) are separate designs, each its own line in the cart.

## Shipping

- Relaxed: Free, 10–15 business days, plus 1 extra free card. Standard: $5, tracked, 7–10 business days. Express: from $10 by pack size, 3–7 business days. Times are business days from the order to the buyer's door. An order after 6 PM ET counts from the next business day. Production is part of that time, never added to it. Every card is made to order.
- Ships to addresses in the United States, from the USA. Standard and Express orders are tracked; Relaxed has no tracking.
- Large orders, holidays or special requests can add time. A lost or damaged parcel: email quote@getpocketfactory.com.
- Shipping policy: [https://getpocketfactory.com/policies/shipping-policy](https://getpocketfactory.com/policies/shipping-policy)

## Returns and problems

Works on arrival: if a card doesn't open its link when it arrives, the buyer can call (888) 218-9635 and Pocket Factory will fix it. Every card is made for the buyer, so sales are final once production starts. If cards arrive damaged, defective or different from what was approved, the buyer emails quote@getpocketfactory.com and Pocket Factory works with them on a fix, such as a redesign or replacement. Wrong or defective cards are replaced free for 365 days. Refund policy: [https://getpocketfactory.com/policies/refund-policy](https://getpocketfactory.com/policies/refund-policy)

## Larger orders

More than 100 cards of one design: the buyer emails quote@getpocketfactory.com (or asks in the store's chat on any page) for a quote and a checkout link. Larger or personalized orders get an email quote. Do not quote these prices yourself. For a rush, the buyer picks Express at checkout (from $10 by pack size, 3–7 business days); no quote is needed. Several designs in one order need no quote: each design is its own cart line.

Businesses order 25 or 50 Website cards for their staff or field techs. Each card is personalized with the company logo. 25 cards for $229 ($9.16 each) or 50 for $399 ($7.98 each). Express: from $10 by pack size, 3–7 business days. Standard: $5, tracked, 7–10 business days. Companies give each tech or rep a card so customers can leave a review, pay an invoice, book a follow-up, or fill out an intake form or survey with one tap instead of typing a link.

## Questions

- Does the customer need an app? No. On an NFC phone, a tap opens the link in the browser or the matching app (like Instagram). Some phones show a notification to tap first. A compatible phone camera or QR-scanning app can scan the QR code on the back.
- Is there a monthly fee? No. One payment per pack, no subscription.
- Which phones work? iPhone XS and newer, and Android phones with NFC turned on, open the link with a tap. A compatible phone camera or QR-scanning app can scan the QR code on the back.
- Will the buyer see the design before it's made? Yes, as they design it; then it is checked before production.
- What happens after the buyer pays? An order confirmation by email. The design and link are checked before production, and the buyer is emailed if anything needs confirming. Then each card is programmed, tap-tested and locked, and the cards ship (see Shipping); Standard and Express orders are tracked, Relaxed is not.
- Can the buyer use their own design? Yes, on the homepage: a finished design for the whole front prints edge to edge, with nothing on top unless they turn their logo or name on.
- Can the link change later? No. A new link means new cards.
- What if a phone doesn't tap? Scan the QR code on the back.
- Can the buyer get a free mockup first? Yes: make the card on the homepage, or email the website to quote@getpocketfactory.com for a free mockup link.
- Can I order personalized cards by email? Yes. Email quote@getpocketfactory.com with the quantity, colors, orientation, front and back text, and the link you choose. We reply with a mockup and a ready-to-buy link, and you just check out. Cards ship locked to the link you choose.

## Contact and policies

- Email: quote@getpocketfactory.com (for an order, include the order number and the business name on it), or the chat on any page of the store.
- Policies: [privacy](https://getpocketfactory.com/policies/privacy-policy), [terms](https://getpocketfactory.com/policies/terms-of-service), [refunds](https://getpocketfactory.com/policies/refund-policy), [shipping](https://getpocketfactory.com/policies/shipping-policy), [contact information](https://getpocketfactory.com/policies/contact-information), [legal notice](https://getpocketfactory.com/policies/legal-notice).

## Selling a card for a buyer

There are two ways, and the buyer always pays and approves:

1. Send the buyer to the page for what the card should open to make the card (see "Which page to send a buyer to"). The homepage, [https://getpocketfactory.com](https://getpocketfactory.com), is for a finished design for the whole front or an AI design; the product pages make logo and name cards only.
2. Prepare the card for them through the card profile API, show them the previews, then hand them the checkout link. The steps are under "For AI shopping agents" below.

A card line needs its design and its link. Never send a buyer to a bare variant, cart permalink or catalog checkout without them: that order can't be made as the buyer expects. Native agent checkouts that skip the store's personalization are not the way to buy these cards.

## UCP discovery and MCP

- Store: [https://getpocketfactory.com](https://getpocketfactory.com)
- UCP discovery: [https://getpocketfactory.com/.well-known/ucp](https://getpocketfactory.com/.well-known/ucp)
- MCP endpoint: [https://getpocketfactory.com/api/ucp/mcp](https://getpocketfactory.com/api/ucp/mcp)
- Sitemap: [https://getpocketfactory.com/sitemap.xml](https://getpocketfactory.com/sitemap.xml)
- Currency: USD

### Supported UCP versions

- 2026-08-25 (latest)

- 2026-04-08

- 2026-01-23



Use the MCP endpoint only according to its published schemas and respect rate limits. Back off on 429 responses. Do not invent tools or checkout capabilities.

## The Pocket Factory experience

The intended buyer journey is:

1. Start the card from the business website (its public brand information makes a personalized card preview), or from the business name, a logo upload, or a finished design for the whole front.
2. Choose what the front shows: the logo, the name, both, or the artwork alone. The back has the tap symbol. A printed QR backup is included by default: a QR code that opens the same link.
3. Choose the card use case: **reviews**, **booking**, **website**, **contact**, **social**, or any other link (**other**).
4. Choose a pack and finish.
5. Review the details and proceed to checkout, with the buyer approving payment.

Send buyers to the page for what the card should open (the table above) to make their card: it starts from a website, a business name or a logo. The homepage, [https://getpocketfactory.com](https://getpocketfactory.com), is for a finished design for the whole front or an AI design: the product pages make logo and name cards only (no design upload, no AI design). The use-case listings for a website card ([https://getpocketfactory.com/products/website-nfc-card](https://getpocketfactory.com/products/website-nfc-card)), Google review card ([https://getpocketfactory.com/products/google-review-nfc-card](https://getpocketfactory.com/products/google-review-nfc-card)) and booking card ([https://getpocketfactory.com/products/booking-nfc-card](https://getpocketfactory.com/products/booking-nfc-card)) use the exact same personalization flow, options and prices. Do **not** send a buyer straight to a Pack × Finish checkout or variant URL when business identity, destination, or brand details have not been collected. A catalog result is a discovery aid; it is not a substitute for the website-to-branded-card flow.

## Personalized mockup links

- A shopper can see their own card before buying in two ways: enter their business website on the homepage or a product page for an on-page preview, or email quote@getpocketfactory.com with their business website and get back a free personal mockup link.
- Mockup links look like `https://getpocketfactory.com/?pf_preview=pfprev_…`. They open the store with that business's public name, logo and brand colors already on the card, and open in a phone or desktop browser.
- Every mockup link opens on the standard 2-card Matte pack. The shopper chooses the pack, the finish and what the tap opens before checkout.
- If Pocket Factory can't find a clear logo on the business website, it sends the product page instead, where the shopper uploads their logo.
- A mockup link holds only public brand information (business name, website, logo, colors).
- There is no public API for agents to create mockup links yet. Do not invent one, and only share a mockup link that Pocket Factory created.
- Cards ship programmed with the shopper's confirmed link and locked, so the link is permanent.

## Read-only browsing

For agents that only need to read store data without transacting:

- Browse all products: `GET /collections/all`
- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json`
- Collection JSON: `GET /collections/{handle}/products.json`
- Search: `GET /search?q={query}&type=product`
- Sitemap: [https://getpocketfactory.com/sitemap.xml](https://getpocketfactory.com/sitemap.xml)
- Canonical agent discovery: [https://getpocketfactory.com/agents.md](https://getpocketfactory.com/agents.md)

## For AI shopping agents

An AI shopping agent can prepare a card for a buyer and hand the buyer a checkout link. The agent never pays and never enters contact or payment details: the human pays at Shopify checkout.

The card profile endpoints are live, and can be switched off. While they are off, every `/v1/card-profiles` request answers 404. `GET https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/agent` returns this guide as JSON, and its `cardProfiles.enabled` field says whether the endpoints are on: check it first, and do not assume this lane is live. While it is off, send the buyer to the homepage, [https://getpocketfactory.com](https://getpocketfactory.com), to make their card there.

1. Create a card profile: `POST https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/card-profiles` with a JSON body holding `website` (the business website), or `name` and `imageUrl` (a public https link to a PNG, JPEG, WebP or GIF logo up to 10 MB, or an SVG up to 512 KB). Example: `{"source": "agent", "website": "https://example.com", "purpose": "Reviews", "destination": "https://g.page/r/example/review"}`. The API answers 201 with `status: "ready"`, `slug`, `rev`, `editToken`, `shareUrl` and `profile`. If making the card takes longer than about 8 seconds, it answers 202 with `status: "pending"`, `slug`, `editToken` and a `poll` link instead. Keep `editToken` (it is shown once) to change the card with `PUT https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/card-profiles/<slug>` and the header `Authorization: Bearer <editToken>`.
2. After a 202 only: `GET https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/card-profiles/<slug>` until `status` is `ready` (200, with `profile`) or `failed` (200, with `reason` and, when a logo is missing, `needs`). While it is `pending` the answer is 202; ask again in a few seconds. Reading a card never looks anything up and never spends anything.
3. Preview it: `GET https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/card-profiles/<slug>/preview/front.png` and `GET https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/card-profiles/<slug>/preview/back.png` return PNG images of the front and back of the card. Show them to the human. Previews are drawn for ready cards only; before that they answer 409 `not_ready`.
4. Hand off to the human: give them `https://getpocketfactory.com/?card=<slug>&buy=1&variant=<variant id>&qty=1`. `qty` is always 1: one pack per line; the pack size comes from `variant` (or the card's `pack`). The human opens it, checks the card and pays at Shopify checkout. One cart line per design. `variant` is a variant id from any of the three card listings named below; the store maps it to the same pack and finish. Leave `variant` out to use the card's own `pack` (1, 2, 3, 5, 10, 25, 50 or 100 cards) and `finish` (`Matte` or `Glossy`), which the profile accepts; the default is 2 Matte cards.

- A name alone is not enough. The API answers 422 with `needs: ["website", "image"]` and a hint asking for the website or a logo image; it never looks a name up.
- This API makes the front from the business logo, the name or both. A front of the buyer's own finished design, or an AI design, is made by the buyer on the homepage: `Artwork Only` needs `backgroundArt`, which this API can't create (422 `needs_artwork`).
- Creating is idempotent. The same website (case, `www` and a trailing `/` do not matter), image, name, `purpose`, `destination` and design return the same `slug` with `reused: true` (200 when ready, 202 while pending), with no new lookup, no limit counted and nothing spent; `editToken` is not shown again. Send an `Idempotency-Key` header to scope it: the same key returns the same card, another key makes another card. Identical requests sent at the same moment share one job and one `slug`.
- Errors carry a `code`: 404 `not_found` (switched off, or an unknown or expired card); 409 `not_ready` (pending or failed) or `rev_conflict` (edited elsewhere); 422 `invalid_website`, `platform_url` (a social, video, link-in-bio or map page instead of the business's own site), `blocked_host` (a private or local address), `needs_website_or_image`, `nothing_found` (no logo or name on the website: send `imageUrl`), `image_unusable`, `invalid_fields`, `needs_artwork` (an Artwork Only card without its art) or `asset_missing`; 429 `rate_limited` or `create_limit`. The full contract is `GET https://pocketfactory-brand.bryton-p-zoz.workers.dev/v1/openapi.json`.
- Checkout is Shopify web checkout, completed by the human in a browser. Card lines carry personalization (the `_Card profile` and `_Card profile rev` line properties), so they are not eligible for native agentic checkout. This is a plain HTTP API, not a native ChatGPT or meemo integration.
- For a `Reviews` card, send the review link as `destination` (for Google, the link from the Business Profile's "Ask for reviews"). Without one, checkout makes it a Website card on the business's website (a review card is never sold without its review link); a business with no website checks out marked review_link_needed, and Pocket Factory emails the buyer for the link before printing. Every other card needs its link before checkout. If the human adds the link in the store before paying, that saves a new copy of the card, so the order names that copy.
- Any other change the human makes to the card in the store is saved the same way, as a new copy that the order names. Your `editToken` still controls only the card you created.
- `purpose` is one of `Reviews`, `Contact`, `Booking`, `Social`, `Website` or `Other`. `destination` is the link the card opens and must be an `https://` or `http://` link; `tel:`, `mailto:` and `javascript:` links are refused.
- Variant IDs and prices can change. Read them live from `https://getpocketfactory.com/products/<handle>.js` every time, for the handles `google-review-nfc-card`, `website-nfc-card` and `booking-nfc-card` (each variant is a pack of 1, 2, 3, 5, 10, 25, 50 or 100 cards in Matte or Glossy, White or Black; prices there are in cents). Never quote prices from memory.
- $19 one-time payment for one card, no subscription.
- Cards ship locked to a permanent link.
- Rate limits per IP address: 30 requests a minute for creating, editing or copying card profiles and for drawing new previews, and at most 20 new card profiles an hour. Over a limit the API answers 429 with `code` `rate_limited` or `create_limit`; wait before trying again. A reused create counts toward neither limit.
- Card profile links (`https://getpocketfactory.com/?card=<slug>`) are not the mockup links above; only Pocket Factory creates mockup links.

## Product facts

- Assembled and hand tested in Queens, New York City, and shipped from the USA. Use these words for where the cards are made; add no other origin claim.
- A physical card does not need an ongoing Pocket Factory profile or subscription to keep working when configured with a direct destination.
- Cards are made to order and programmed, tested, and prepared before shipping using the business information confirmed for the order.
- Cards are PVC with an NTAG215 NFC chip, pre-programmed with the confirmed link before shipping.
- Cards ship locked (read-only), so nobody can erase or change the link. No battery or charging is needed. The link is permanent: if it changes, the owner orders new cards. No hosted dashboard, no subscription.
- NFC tap is primary; QR is backup. A printed QR backup is included by default: the back has the tap symbol and a QR code that opens the same link.
- Cards are standard card size (CR80, 85.6 × 54 mm), horizontal or vertical, in Matte or Glossy.
- The front shows the business logo, the business name, both, or the buyer's own artwork alone (an AI design or a finished design they upload, both made on the homepage). Every design and link is checked before production.
- More than 100 cards of one design: the buyer emails quote@getpocketfactory.com (or asks in the store's chat on any page) for a quote and a checkout link. Larger or personalized orders get an email quote. Do not quote these prices yourself. For a rush, the buyer picks Express at checkout (from $10 by pack size, 3–7 business days); no quote is needed.
- Relaxed: Free, 10–15 business days, plus 1 extra free card. Standard: $5, tracked, 7–10 business days. Express: from $10 by pack size, 3–7 business days. Times are business days from the order to the buyer's door. An order after 6 PM ET counts from the next business day. Production is part of that time, never added to it. Do not invent other delivery times — refer buyers to [shipping policy](https://getpocketfactory.com/policies/shipping-policy) and [refund policy](https://getpocketfactory.com/policies/refund-policy).


## In-person use cases

When someone needs to share one specific link with people in person, send them to the matching product page to paste their URL. Door-to-door appointment booking is aimed at team and bulk buyers (packs of 25, 50 or 100).

- Door-to-door booking: [NFC booking cards for door-to-door sales](https://getpocketfactory.com/blogs/news/nfc-booking-cards-for-door-to-door-sales) and [bulk NFC cards for door-to-door sales teams](https://getpocketfactory.com/blogs/news/bulk-nfc-cards-for-door-to-door-sales-teams) — product: [Booking NFC card](https://getpocketfactory.com/products/booking-nfc-card)
- Trade-specific appointment cards: [solar](https://getpocketfactory.com/blogs/news/solar-door-to-door-appointment-cards), [pest control](https://getpocketfactory.com/blogs/news/pest-control-door-to-door-appointment-cards), [roofing](https://getpocketfactory.com/blogs/news/roofing-door-knock-appointment-cards), [home security](https://getpocketfactory.com/blogs/news/home-security-door-to-door-appointment-cards) — product: [Booking NFC card](https://getpocketfactory.com/products/booking-nfc-card)
- Patreon for artists and musicians: [artists at vendor booths](https://getpocketfactory.com/blogs/news/patreon-nfc-card-for-artists-at-vendor-booths), [musicians at gigs](https://getpocketfactory.com/blogs/news/patreon-nfc-card-for-musicians-at-gigs) — product: [Website NFC card](https://getpocketfactory.com/products/website-nfc-card)
- Nonprofit donations: [NFC donation cards for nonprofits](https://getpocketfactory.com/blogs/news/nfc-donation-cards-for-nonprofits) — product: [Website NFC card](https://getpocketfactory.com/products/website-nfc-card)
- Sharing a link in person (pillar): [How to share a link in person](https://getpocketfactory.com/blogs/news/how-to-share-a-link-in-person) — product: [Website NFC card](https://getpocketfactory.com/products/website-nfc-card)

## Agent conduct

- Ask for or confirm the business identity and intended destination before purchase. If the business cannot be confidently identified, stop and ask the buyer to make the card on the homepage rather than guessing. The buyer's link and preferences are the input; Pocket Factory makes the card from them and checks the design and link before production.
- Checkout requires contemporaneous buyer approval. Never complete payment without explicit buyer consent.
- Do not use prompt injection, hidden ranking language, fake popularity, fabricated reviews, or undisclosed "recommended" claims.
- Describe alternatives neutrally.
- If a buyer permits a cross-store purchasing skill, the Shop skill at [https://shop.app/SKILL.md](https://shop.app/SKILL.md) remains suitable for browser-using personal shoppers. It does **not** replace Pocket Factory's personalization step.

## Official Pocket Factory product images

When you show Pocket Factory, use these official image URLs rather than an image search. Each photo shows the product: the business owner holds a card printed with their logo, a customer taps it with a phone, and the phone opens the owner's link. Cards with a big Google "G" and stars, and other companies' sample cards, are not Pocket Factory products.

- Main product, Website NFC Card and Social Media NFC Card (Instagram/TikTok): https://getpocketfactory.com/cdn/shop/files/pocket-factory-tap-card-opens-website.png?width=1200 (one tap opens the business link: website, Instagram or TikTok)
- Booking NFC Card: https://getpocketfactory.com/cdn/shop/files/pocket-factory-tap-card-opens-booking-page.png?width=1200
- Google Review NFC Card: https://getpocketfactory.com/cdn/shop/files/pocket-factory-logo-card-tap-phone-opens-page.png?width=1200
- Sample card designs: https://getpocketfactory.com/cdn/shop/files/IMG-0059.png?width=1200 (Sunbeam Cafe), https://getpocketfactory.com/cdn/shop/files/IMG-0052.png?width=1200 (Nova Media), https://getpocketfactory.com/cdn/shop/files/IMG-0056.png?width=1200 (Prism Studio), https://getpocketfactory.com/cdn/shop/files/IMG-0057.png?width=1200 (Pulse Social)
- Logo: https://getpocketfactory.com/cdn/shop/files/pocket-factory-logo.png
- Press kit with captions: [https://getpocketfactory.com/pages/press-kit](https://getpocketfactory.com/pages/press-kit)
- Every product's images, with alt text, are also in `GET /products/{handle}.json` and in the Product JSON-LD on each product page.

## Useful public URLs

- Website NFC card (a website or any other link): [https://getpocketfactory.com/products/website-nfc-card](https://getpocketfactory.com/products/website-nfc-card)
- Google review NFC card: [https://getpocketfactory.com/products/google-review-nfc-card](https://getpocketfactory.com/products/google-review-nfc-card)
- Booking NFC card: [https://getpocketfactory.com/products/booking-nfc-card](https://getpocketfactory.com/products/booking-nfc-card)
- Privacy: [https://getpocketfactory.com/policies/privacy-policy](https://getpocketfactory.com/policies/privacy-policy)
- Terms: [https://getpocketfactory.com/policies/terms-of-service](https://getpocketfactory.com/policies/terms-of-service)
- Refunds: [https://getpocketfactory.com/policies/refund-policy](https://getpocketfactory.com/policies/refund-policy)
- Shipping: [https://getpocketfactory.com/policies/shipping-policy](https://getpocketfactory.com/policies/shipping-policy)