This article will discuss how to enable dynamic recurring payments on your form.
Dynamic payments mean that you link form items such as dropdown menus, radio buttons, input fields, or even hidden fields to get passed to PayPal or Stripe. In this case we will link form items that can be used to control recurring payment values, such as the billing cycle.
If you don’t want to link form items to recurring values you can instead set fixed values in the static section.
In this example we will link a dropdown menu to the recurring amount and description.
1. On the Form tab make a dropdown menu. The different options contains all the parameters needed. The different parameters are separated by pipes which look like |.
Here is an example of a dropdown menu:
[select menu-774 “Item 1 – Pay Monthly|7.25|1|month|0” “Item 2 – Pay Weekly|10.75|2|week|10” “Item 3 – Pay Yearly|60.25|1|year|3”]
Important: The description part (example: Item 1 – Pay Monthly) cannot contain $,(,),/’,” symbols.
In the example for the first option, Item 1 – Pay Monthly is the name of the option,7.25 is the amount, 1 is the billing frequency, month is the period, and 0 for the billing cycle means that billing will go on forever. So this example would result in $7.25 billed every month forever.
In the example for the second option, Item 2 – Pay Weekly is the name of the option, 10.75 is the amount, 2 is the billing frequency, week is the period, and 10 for the billing cycle means that the billing will continue for 10 cycles. So this example would result in $10.75 billed every 2 weeks for 10 installments.
In the example for the third option, Item 3 – Pay Yearly is the name of the option, 60.25 is the amount, 1 is the billing frequency, year is the period, and 3 for the billing cycle means that the billing will continue for 3 installments. So this example would result in $60.25 billed every 1 year for 3 installments.
What options can you use?
- For the amount, you can pass any amount.
- For the billing frequency, you can pass 1-52.
- For the period, you can use day, week, month, year.
- For the billing cycle, you can use 0 and 2-30. Using 0 will mean that the billing will continue forever. This option is only available for PayPal, Stripe will ignore the number of cycles and bill everything forever.
- If you pass a 1 for the billing cycles option, it will be a one time payment. Full documentation on this is available here.
Please note that for Stripe: A maximum of one year interval is allowed (1 year, 12 months, or 52 weeks). For PayPal: A maximum of 5 year interval is allowed.
2. On your forms PayPal & Stripe tab, in Dynamic Values section, enter the dropdown menu form code in the Price Code 1 and Description Code 1 fields and make sure that the Recurring checkbox is checked:
