End free trial

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Ends your workspace's free trial now and starts the paid plan. Only the workspace owner can end it. This works only for a workspace billed through Wix that's in a free trial. Otherwise it returns 400 with not_wix_billed or not_in_free_trial.

<Warning>This charges the saved payment method for the first billing cycle right away, with no confirmation step.</Warning>

<Warning>A declined card isn't an error. The response is 200 with status set to payment_declined or payment_declined_not_retriable, and the workspace stays in its free trial. Check status before you treat the trial as ended.</Warning>

To fix a declined card, update it with Create payment method update session, then call this again.

The base rate limit is 10 requests per hour per user. See Rate limits for the multiplier your plan gets.

post/api/billing/end-free-trial

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/billing/end-free-trial
  • Auth
    HTTP bearer

Response

The outcome of the charge. Check status.

status'ended_successfully' | 'payment_pending' | 'payment_declined' | 'payment_declined_not_retriable' | 'unknown_status' required

ended_successfully: the trial is over and the first cycle is paid. payment_pending: the charge is still processing. payment_declined: the card was declined and the trial continues, so you can retry. payment_declined_not_retriable: declined, and retrying won't help until the payment method changes. unknown_status: Wix didn't report an outcome.

invoice_idstring nullable required

ID of the invoice for the first cycle. null when none was issued.

Example response

{
  "status": "ended_successfully",
  "invoice_id": "9a8b7c6d-1234-4f5e-8a9b-0c1d2e3f4a5b"
}

Changes