Subscription Plans

POST /v1/plans
Idempotency-Key: <uuid-v4>

{
  "name": "Monthly Lens Supply",
  "interval": "monthly",          // monthly · quarterly · yearly
  "price_cents": 2500,
  "currency": "usd",
  "trial_days": 14
}

{
  "plan_id": "plan_123",
  "name": "Monthly Lens Supply",
  "interval": "monthly",
  "price_cents": 2500,
  "currency": "usd",
  "trial_days": 14,
  "status": "ACTIVE",
  "created_at": "2025-06-05T12:00:00Z"
}

GET /v1/plans
Authorization: Bearer <merchant_api_token>

GET /v1/plans/{plan_id}
Authorization: Bearer <merchant_api_token>

PUT /v1/plans/{plan_id}
Idempotency-Key: <uuid-v4>

DELETE /v1/plans/{plan_id}
Authorization: Bearer <merchant_api_token>

POST /v1/products/{product_id}/attach-plans
Idempotency-Key: <uuid-v4>

{
  "plan_ids": ["plan_123", "plan_456"]
}

{
  "product_id": "prod_abc123",
  "attached_plan_ids": ["plan_123", "plan_456"]
}

POST /v1/products/{product_id}/detach-plans
Idempotency-Key: <uuid-v4>

{
  "plan_ids": ["plan_123"]
}

{
  "product_id": "prod_abc123",
  "attached_plan_ids": ["plan_456"]
}