---
title: "Confirm Subscription"
method: POST
path: "/billing/confirm-subscription"
tags: ["billing"]
---

# Confirm Subscription

`POST /billing/confirm-subscription`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/billing/confirm-subscription`
- Auth: HTTP bearer

Success-page fallback that applies a completed subscription checkout without
waiting on the Stripe webhook.

Idempotent with the webhook — both go through sync_subscription. It exists
because the webhook claims its dedup row before processing, so a handler that
died partway through left a paying customer on Starter with nothing that
would ever retry.

## Request body

- ConfirmSubscriptionRequest
  - `session_id` string, required

## Response `200`

Successful Response

- BillingStatusResponse
  - `plan` 'starter' | 'influencer' | 'creator', required
  - `billing_type` string, nullable, required
  - `subscription_status` string, nullable, required
  - `subscription_current_period_end` string, nullable, required
  - `subscription_interval` string, nullable, required
  - `cancel_at_period_end` boolean, required
  - `is_active` boolean, required
  - `stripe_publishable_key` string, required
  - `image_gen_used` integer, required
  - `image_gen_limit` integer, nullable, required
  - `image_credits` integer, required
  - `referral_credit_months` integer
  - `referral_credit_cents` integer
  - `referral_credit_currency` string, nullable
  - `referral_comp_plan` string, nullable
  - `referral_comp_ends_at` string, nullable
  - `referral_half_off_months` integer
  - `referral_half_off_ends` string, nullable
  - `pending_plan` 'starter' | 'influencer' | 'creator'
  - `pending_plan_effective_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reeldrop/apis/reeldrop-api.md) · [All operations](https://skmtc.dev/reeldrop/apis/reeldrop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reeldrop/apis/reeldrop-api/revisions/d3b2a338556c?raw)