# service_stripe_new_user_checkout_create

Stripe checkout session API View for new users (first-time subscription)

Request the following fields:

- user_id, username, or email (user identifier)
- tenant (tenant type to create after successful checkout)
- sku
- mode (choices: "subscription", "payment", "setup")
- success_url
- cancel_url
- period (optional): Billing period - "weekly", "monthly", or "yearly" (defaults to "monthly")
- skip_card (optional): Skip card collection for free plans
- is_free_trial (optional): Enable free trial mode

Response:
{
    "redirect_to": "https://checkout.stripe.com/xxx/xxxx/xxxx",
}

Endpoint: POST /api/service/stripe/new-user-checkout/
Version: 4.84.1-ai-plus
Security: PlatformApiKeyAuthentication

## Request fields (application/json):

  - `sku` (string)
    Product SKU

  - `product` (string)
    Alternative to SKU

  - `tenant` (string, required)
    Tenant type to create after successful checkout

  - `success_url` (string, required)
    URL to redirect after successful payment

  - `cancel_url` (string, required)
    URL to redirect if checkout cancelled

  - `mode` (string)
    Checkout mode

* subscription - subscription
* payment - payment
* setup - setup
    Enum: "subscription", "payment", "setup"

  - `period` (string)
    Billing period

* weekly - weekly
* monthly - monthly
* yearly - yearly
    Enum: "weekly", "monthly", "yearly"

  - `metered` (boolean)
    Whether to use metered billing

  - `quantity` (integer)
    Subscription quantity

  - `coupon` (string)
    Coupon code to apply

  - `is_free_trial` (boolean)
    Enable free trial

  - `trial_days` (integer)
    Trial period in days

  - `skip_card` (boolean)
    Skip card collection for trial

## Response 200 fields (application/json):

  - `redirect_to` (string, required)