Skip to content

Pubky Market

Markdown

Pubky Market adds shops and product listings to Pubky, with buyers paying sellers directly. Sellers publish a catalog under their Pubky identity, and buyers discover products and follow their orders. Pubky Market supports physical and digital goods, with sale formats such as fixed-price listings, auctions, and timed releases called drops.

A seller’s shop and listings are public records on their Homeserver. Reviews and related public commerce records use shared formats so compatible clients and indexers can read them. Pubky Market’s catalog is therefore more than data held inside one shop interface.

A dedicated marketplace Nexus indexes those records for browsing and search. Its catalog views are derived data; the seller’s Homeserver records remain the source of their published catalog.

Publishing a listing and completing a sale are separate actions. A transaction service coordinates shared decisions such as reserving stock, accepting an offer, closing an auction, and advancing an order. A cached listing or a Homeserver write cannot establish that a buyer reserved the last item or paid for it. The transaction-authority explanation describes this division of responsibilities.

  1. A seller publishes a shop and listing, with prices, inventory, delivery options, and sale terms.
  2. A buyer finds the listing and starts checkout. The transaction service coordinates the reservation and records the order’s agreed terms.
  3. The buyer pays the seller through an available payment method. The service reconciles the payment result before advancing the order.
  4. The seller fulfills the order, or the buyer receives the purchased digital delivery. Order history and signed receipts help the participants retain evidence of the transaction.

Paykit coordinates payment discovery and requests, while Pubky Locks controls access to purchased content, such as paid articles and downloadable files. Pubky Market integrates these building blocks with its order workflow. They do not replace the transaction service’s inventory and order decisions.

Payments go to the seller; Pubky Market does not custody funds or send refunds from a platform balance. Buyers and sellers still rely on the chosen payment method, the seller’s fulfillment, and the transaction service’s order decisions.

  • Try Pubky Market: Open Pubky Market to browse shops and listings.
  • Contribute to the Pubky Market web app: Follow the developer guide to set up Pubky Market locally and contribute features or bug fixes.
  • Build compatible records: Use Pubky Market Specs for the data model and Rust and JavaScript libraries.
  • Automate shop operations: Use the seller automation API to synchronize inventory, export orders, receive order notifications, and update shipping or tracking information.