Create Plan

Creates a new subscription billing plan with the supplied parameters.

  • plan_type accepts day, week, month, year.
  • plan_length is the length of the plan type.
  • plan_trial_days is the length of the trial period in days.
  • recurring_price_(USD|GBP|EUR) is the amount that will be charged for each payment.
  • main_currency_code accepts USD, GBP or EUR (default: USD). Please note that the currency you chose will affect how you write the initial_price_ and the recurring_price_ parameter. So if your main_currency_code is GBP, the initial_price parameter will be initial_price_gbp and the recurring_price will be recurring_price_gbp

In the below example, we are creating a subscription plan with 0 trial days where the user will be charged $5 every 2 months.

Example Request The example below


curl -X POST \
     -d 'vendor_id=123' \
     -d 'vendor_auth_code=14a5df6abc' \
     -d 'plan_name=My Subscription Plan' \
     -d 'plan_trial_days=0' \
     -d 'plan_type=month' \
     -d 'plan_length=2' \
     -d 'main_currency_code=USD' \
     -d 'recurring_price_usd=5.00' \
     https://vendors.paddle.com/api/2.0/subscription/plans_create

Example Response


{
    "success": true,
    "response": {
        "product_id": 502198
    }
}

You can now use the returned product_id/plan_id with other subscription APIs.

Questions about Paddle?

If you need any help regarding your Paddle integration, please get in touch with our Customer Success team using the form below.