COcodag
billing

Create Monthly Switch Portal

Changed on

Switch an annual Team subscription to monthly.

Paid annual subscribers get Stripe's confirmation UI: the server does not mutate the subscription; Stripe shows the exact unused-time credit and applies the update only after the customer explicitly confirms it.

TRIALING annual subscribers (deal-link 30-day opt-out window) are switched directly with trial_end="now": monthly has no trial by policy, so the switch ends the window and charges the first $499 immediately. The console button states the charge; error_if_incomplete keeps the subscription unchanged if the card declines.

post/api/billing/monthly-switch-portal

Request

Request body

deal_codestring required

Response

Successful Response

portal_urlstring required
statusstring required

Changes

  • 64da737bcc9eRevision changes
    • breaking

      added the pattern ^[A-Za-z0-9_-]+$ to the request property

    • info

      api operation id monthly_switch_portal_api_billing_monthly_switch_portal_post removed and replaced with create_monthly_switch_portal_api_billing_monthly_switch_portal_post

    • info

      the response property became required for the status

    • info

      response property portal_url list-of-types was narrowed by removing types null from media type application/json of response 200

  • 44d8ea826f48Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      response property portal_url list-of-types was widened by adding types null to media type application/json of response 200

    • info

      api operation id create_monthly_switch_portal_api_billing_monthly_switch_portal_post removed and replaced with monthly_switch_portal_api_billing_monthly_switch_portal_post

    • info

      removed the pattern ^[A-Za-z0-9_-]+$ from the request property