subscriptions

Create Topup Checkout Session

Changed on

Create a Stripe Checkout session for a one-time credit top-up.

Eligibility (DRAFT_SPEC_TRIAL_TOPUP §3): active subscription past the first invoice, OR a running plan clock (trial / churn wind-down). The Stripe customer is created on the fly for clock-path buyers.

post/conglomerates/{conglomerate_id}/topup-checkout-session

Request

  • Base URL: https://api.nanocorp.so (the document declares no server; this is the origin it was published from)
  • URL: https://api.nanocorp.so/conglomerates/{conglomerate_id}/topup-checkout-session
  • Auth: HTTP bearer

Path parameters

conglomerate_idstring uuid required

Headers

X-Posthog-Session-Idstring nullable
X-Client-Mobilestring nullable
X-Meta-Fbcstring nullable
X-Meta-Fbpstring nullable
X-Meta-Source-Urlstring nullable
X-Tiktok-Ttclidstring nullable
X-Tiktok-Ttpstring nullable
X-Tiktok-Click-Timestring nullable

Request body

creditsinteger required
company_idstring uuid required

Response

Successful Response

checkout_urlstring required

Changes

  • a3f5a6c0e56cRevision changes
    • info

      added the new optional header request parameter X-Tiktok-Click-Time

    • info

      added the new optional header request parameter X-Tiktok-Ttclid

    • info

      added the new optional header request parameter X-Tiktok-Ttp

  • 113752ab03f9Revision changes
    • info

      added the new optional header request parameter X-Meta-Fbc

    • info

      added the new optional header request parameter X-Meta-Fbp

    • info

      added the new optional header request parameter X-Meta-Source-Url