@whop/react/dist/checkout/embed.d.ts

React SDK for building embedded apps on Whop

import { type WhopCheckoutState, type WhopEmbeddedCheckoutPrefillOptions, type WhopEmbeddedCheckoutStyleOptions } from "@whop/checkout/util";
import { type ReactNode, type RefObject } from "react";
import { type AccentColor } from "./colors";
import { type WhopCheckoutEmbedControls } from "./util";
export interface WhopCheckoutEmbedThemeOptions {
    /**
     * **Optional** - The accent color you want to use in the embed.
     *
     * defaults to `blue`
     */
    accentColor?: AccentColor;
}
export interface WhopCheckoutEmbedProps {
    /**
     * **Required** - The plan id you want to checkout.
     */
    planId: string;
    /**
     * **Optional** - A ref to the embed controls.
     *
     * This can be used to submit the checkout form.
     */
    ref?: RefObject<WhopCheckoutEmbedControls | null>;
    /**
     * **Optional** - The theme you want to use for the checkout.
     *
     * Possible values are `light`, `dark` or `system`.
     *
     * @default "system"
     */
    theme?: "light" | "dark" | "system";
    /**
     * **Optional** - The session id to use for the checkout.
     *
     * This can be used to attach metadata to a checkout by first creating a session through the API and then passing the session id to the checkout element.
     */
    sessionId?: string;
    /**
     * **Optional** - Turn on to hide the price in the embedded checkout form.
     *
     * @default false
     */
    hidePrice?: boolean;
    /**
     * **Optional** - Set to `true` to skip the final redirect and keep the top frame loaded.
     *
     * @default false
     */
    skipRedirect?: boolean;
    /**
     * **Optional** - A callback function that will be called when the checkout is complete.
     */
    onComplete?: (
    /** The plan id of the plan that was purchased. */
    plan_id: string, 
    /** The receipt id of the purchase. */
    receipt_id?: string) => void;
    /**
     * **Optional** - A callback function that will be called when the checkout state changes.
     */
    onStateChange?: (
    /** The new state of the checkout. */
    state: WhopCheckoutState) => void;
    /**
     * **Optional** - The UTM parameters to add to the checkout URL.
     *
     * **Note** - The keys must start with `utm_`
     */
    utm?: Record<string, string | string[]>;
    /**
     * **Optional** - The styles to apply to the checkout embed.
     */
    styles?: WhopEmbeddedCheckoutStyleOptions;
    /**
     * **Optional** - The prefill options to apply to the checkout embed.
     *
     * Used to prefill the email in the embedded checkout form.
     * This setting can be helpful when integrating the embed into a funnel that collects the email prior to payment already.
     */
    prefill?: WhopEmbeddedCheckoutPrefillOptions;
    /**
     * **Optional** - The theme options to apply to the checkout embed.
     */
    themeOptions?: WhopCheckoutEmbedThemeOptions;
    /**
     * **Optional** - Set to `true` to hide the submit button in the embedded checkout form.
     *
     * @default false
     */
    hideSubmitButton?: boolean;
    /**
     * **Optional** - Set to `true` to hide the terms and conditions in the embedded checkout form.
     *
     * @default false
     */
    hideTermsAndConditions?: boolean;
    /**
     * **Optional** - Set to `true` to hide the email input in the embedded checkout form.
     *
     * @default false
     */
    hideEmail?: boolean;
    /**
     * **Optional** - Set to `true` to disable the email input in the embedded checkout form.
     *
     * @default false
     */
    disableEmail?: boolean;
}
export type { WhopEmbeddedCheckoutStyleOptions, WhopEmbeddedCheckoutPrefillOptions, };
/**
 * This component can be used to embed whop checkout in your react app:
 *
 * ```tsx
 * import { WhopCheckoutEmbed } from "@whop/react/checkout";
 *
 * export default function Home() {
 *   return <WhopCheckoutEmbed planId="plan_XXXXXXXXX" />;
 * }
 * ```
 */
export declare function WhopCheckoutEmbed({ fallback, ...props }: WhopCheckoutEmbedProps & {
    /**
     * **Optional** - The fallback content to show while the checkout is loading.
     */
    fallback?: ReactNode;
}): ReactNode;