OPopenmercantil
Billing
User

Create a subscription Checkout session

Changed on

Requires a Secure, SameSite browser session and X-CSRF-Token. Trial policy is server-owned: clients cannot send trial_days or no_default_trial. Idempotency is scoped to user, plan and billing period before Stripe.

post/api/v1/checkout

Request

Headers

X-CSRF-Tokenstring required

Fresh token returned by GET /api/v1/user/me for this authenticated session.

Idempotency-Keystring

Request body

plan'profesional' | 'max' | 'pro' | 'business' | 'agency' required
billing'monthly' | 'yearly' | 'anual'
couponstring
csrfstring

Body fallback accepted by the runtime; prefer X-CSRF-Token.

idempotency_keystring

Response

Checkout URL and Stripe session id

urlstring uri required
session_idstring required

Changes