Skip to content

docs: document create endpoints for products and plans#46

Merged
sandervanhooft merged 1 commit into
mainfrom
docs/create-products-plans
Jul 5, 2026
Merged

docs: document create endpoints for products and plans#46
sandervanhooft merged 1 commit into
mainfrom
docs/create-products-plans

Conversation

@sandervanhooft

Copy link
Copy Markdown
Member

Summary

Documents two create operations added upstream in sandervanhooft/vatlify#1778 and shipped in vatly-api-php v0.1.0-alpha.24. These paths were previously read-only, so they weren't covered by the earlier spec sync (#45).

  • One-off ProductsPOST /v1/one-off-products (createOneOffProduct): name, description, basePrice, productType (saas|ebook).
  • Subscription PlansPOST /v1/subscription-plans (createSubscriptionPlan): name, description, basePrice, productType (saas), interval, intervalCount.

Both sections document the approval behaviour (live token → pending pending Vatly review; test token → auto-active) and the subscription-plan interval/productType constraints, with cURL + PHP + response examples matching the spec. Vendored public/openapi.yaml refreshed to the current bundled spec (6217 → 6446 lines; the only delta is these two POST operations + their request schemas).

Verification

  • markdownlint clean on both pages
  • branched off latest main (preserves the SDK-doc sync in content/3.packages/)
  • no new pages, so sitemap unchanged

Adopt vatlify#1778 (shipped in vatly-api-php v0.1.0-alpha.24):

- One-off Products: document POST /v1/one-off-products (createOneOffProduct)
- Subscription Plans: document POST /v1/subscription-plans (createSubscriptionPlan)

Both note the live=pending / test=active approval behaviour and the
plan interval/productType constraints. Refresh vendored public/openapi.yaml.
@sandervanhooft sandervanhooft merged commit 489e803 into main Jul 5, 2026
2 checks passed
@sandervanhooft sandervanhooft deleted the docs/create-products-plans branch July 5, 2026 18:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant