Fulfillment architecture

ListBee now supports two fulfillment modes on every listing: managed (ListBee delivers digital content automatically) and external (your app handles delivery via webhooks). Sell physical goods, AI-generated content, custom services — anything that needs logic after payment.

What changed

New: fulfillment field on listings — "managed" or "external". Defaults inferred from whether content is provided.
New: checkout_schema on listings — collect custom fields from buyers at checkout (text, select, date, address). Max 10 fields.
New: POST /v1/orders/{id}/fulfill — push generated content or mark external orders as fulfilled.
New: POST /v1/orders/{id}/ship — record shipping carrier, tracking code, and seller note.
New: Order status expanded — pending, paid, fulfilled, canceled, failed (was: pending, paid, expired).
New: Order fields — checkout_data, shipping_address, fulfillment_status, carrier, tracking_code, seller_note, paid_at, fulfilled_at.
New: Webhook events — order.fulfilled, order.shipped.
New: configure_webhook readiness action — appears on external fulfillment listings without a webhook.
Breaking: content_type renamed to deliverable_type, content_key to deliverable_key, content_value to deliverable_value, content_meta to deliverable_meta, has_content to has_deliverable.
Breaking: order.completed webhook event removed — replaced by order.paid and order.fulfilled.
Breaking: stripe_session_id removed from order responses.

Migration

Field renames

Before:

1 listing["content_type"]  # "file"
2 listing["has_content"]   # True

After:

1 listing["deliverable_type"]  # "file"
2 listing["has_deliverable"]   # True

Webhook events

Before:

1 if event["type"] == "order.completed":
2     # handle order

After:

1 if event["type"] == "order.paid":
2     # payment confirmed — start fulfillment
3 elif event["type"] == "order.fulfilled":
4     # delivery complete

See the Fulfillment modes guide for the full overview, Selling physical products for address collection, and Dynamic fulfillment for AI-generated content delivery.