1. Home
  2. WP Simple Pay Pro 2.5 & Lite 1.6
  3. Subscriptions Add-on – Setup Fee (Pro 2.5)

Subscriptions Add-on – Setup Fee (Pro 2.5)

Note: Subscription capabilities are included with Business and Elite licenses only.

You can use the setup_fee attribute on the main [stripe_subscription] shortcode, the individual [stripe_plan] shortcodes, or both. You can also use it for plans that have a trial.

The setup fee will only be charged once and it will happen on the initial payment. The customer will only pay the original subscription amount per interval thereafter.

Note: Coupon codes will not be applied to setup fees. Only recurring or separate one-time payments.

Initial Payment Total

The [stripe_total] shortcode can be used to show the amount the will be charged for the initial payment. It will include the setup fee if used..

Note: This shortcode must be used after the subscription shortcode to avoid possible problems. See below for examples.

Recurring Payment Total

You can now also use the [stripe_recurring_total] shortcode to show the amount that will be charged each month. This acts similar to the regular [stripe_total] shortcode but can be used to differentiate between a subscription with a setup fee and the actual amount that the user will pay for the subscription.

Note: This shortcode must be used after the subscription shortcode to avoid possible problems. See below for examples.

Shortcode Examples

Here are some examples (in USD$):

Add a $5.00 fee to a subscription named bronze ($4.99/month). This will make the first payment $9.99 but then the user will be charged $4.99/month after that.

[stripe]
[stripe_subscription id="bronze" setup_fee="500"][/stripe_subscription]
[/stripe]

You can also use the same attribute to assign different setup fees based on the plan. For this example we will use bronze ($4.99), silver ($9.99), and gold ($19.99). This will apply a $1.00 fee for bronze, a $5.00 fee for silver, and there will be no fee for gold.

[stripe]
[stripe_subscription]
[stripe_plan id="bronze" setup_fee="100"]
[stripe_plan id="silver" setup_fee="500"]
[stripe_plan id="gold"]
[/stripe_subscription]
[/stripe]

Now let’s say you want a specific setup fee for some plans but want a generic fee for all the others. Again we will use bronze ($4.99), silver ($9.99), and gold ($19.99). This will add a default setup fee of $2.00 for all plans that don’t have a different setup fee applied individually. This will charge the customer the following depending on what plan they choose: bronze ($6.99), silver ($14.99), gold ($21.99)

Note: The setup fees do not add together.

[stripe]
[stripe_subscription setup_fee="200"]
[stripe_plan id="bronze"]
[stripe_plan id="silver" setup_fee="500"]
[stripe_plan id="gold"]
[/stripe_subscription]
[/stripe]

This is the same example as above except this time we will show the user a live total and also use the new [stripe_recurring_total] shortcode to show the user how much they will pay each month after paying the initial one time setup fee + subscription cost.

Note: The [stripe_total] and [stripe_recurring_total] shortcodes must be after the subscription for this to work properly.

[stripe]
[stripe_subscription setup_fee="200"]
[stripe_plan id="bronze"]
[stripe_plan id="silver" setup_fee="500"]
[stripe_plan id="gold"]
[/stripe_subscription]
[stripe_total label="Your total amount is"]
[stripe_recurring_total label="Recurring payment will be:"]
[/stripe]
Updated on November 19, 2018

Was this article helpful?

Related Articles