# JT's Book Bundles: custom connector

Base URL: https://books.jtversity.com
OpenAPI: https://books.jtversity.com/openapi.json
Catalog: https://books.jtversity.com/catalog.json
MCP (Streamable HTTP): https://books.jtversity.com/mcp

Use the public API directly or use the MCP tools. No catalog/login key is needed. Never request the merchant Stripe secret key.

1. Read products and choose an available bundle within the user's budget. Draft products are not purchasable.
2. POST /api/checkout with productId and optional stable UUID requestId. Save the returned private sessionId. Creating checkout does not take payment.
3. Open checkoutUrl and complete Stripe Checkout through the buyer's authorized Link agent-wallet workflow when supported. Obtain required purchase approval. Otherwise hand the hosted checkout to the buyer; explain the handoff. Do not claim a handoff was an autonomous purchase.
4. After checkout, POST /api/download with sessionId. Only a paid purchase returns a download. Save the PDF for the buyer. If payment is pending, wait for checkout to finish. If fulfillment fails after payment, retry fulfillment, not the purchase.
5. The returned URL stays on this store and rechecks payment whenever it is opened. Never publish it or share it with other users.

Personal-use PDFs only, no resale/private-label rights. Mode: live. A test-mode purchase is not evidence of a successful live Link purchase.

This is a custom connector brief, not an approved Muse directory integration.
