Migrate grandfathered account to a paid plan

POST/api/v1/billing/migrate-from-grandfathered

Create a Stripe Checkout session to move from a grandfathered plan to a paid plan.

Request Body:

  • target_plan: Plan tier to migrate to (self_directed or managed)
  • success_url: Redirect URL after successful payment
  • cancel_url: Redirect URL if checkout is canceled

Prerequisites:

  • Business must currently be on the grandfathered plan tier

Effect:

  • Creates a Stripe Checkout session
  • On payment completion, plan_tier is updated to the target plan

Returns: Checkout URL and session ID.

Operation ID: migrate_from_grandfathered_api_v1_billing_migrate_from_grandfathered_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

target_planstringrequired

Target plan tier: 'self_directed' or 'managed'.

success_urlstringrequired

URL to redirect after successful payment.

cancel_urlstringrequired

URL to redirect if checkout is canceled.

billing_intervalstring

Billing cadence: 'month' or discounted annual 'year'.

One of: month, year

Responses

201Successful Response

successboolean
messagestring
codestring
dataMigrateFromGrandfatheredResponse

400Bad Request - Invalid input

403Forbidden - Insufficient permissions

422Validation Error

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject