Purchase

1// The purchase flow over REST — the twin of app/wix/pricing-plans/purchase.ts. Same export, same
2// signature; the body and the result reading come from purchase-core (the SAME file the SDK
3// transport uses). Purchasing is a MEMBER action, but the hosted flow handles login/signup, the
4// order form, and payment itself, so a visitor token starts it. Never create the order yourself,
5// never hand-build a checkout URL.
6// docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
7import { wixRequest } from "../../shared/rest/client.js";
8import { purchaseBody, redirectUrl, type PurchaseOptions } from "../app/wix/pricing-plans/purchase-core.js";
9import type { Raw } from "../app/wix/pricing-plans/plans-core.js";
10
11export type { PurchaseOptions };
12
13/**
14 * Start the hosted purchase for a plan; resolves to the URL to navigate the FULL document to.
15 * POST /headless/v1/redirect-session  { paidPlansCheckout: { planId }, callbacks: { postFlowUrl, thankYouPageUrl? } }
16 */
17export async function purchasePlan(planId: string, options: PurchaseOptions = {}): Promise<string> {
18  const session = await wixRequest<Raw>("/headless/v1/redirect-session", { body: purchaseBody(planId, options) });
19  return redirectUrl(session);
20}