Subscription Billing

How do I create a plan in Subscription Billing?

In the Subscription Billing section of the Tilopay Admin Dashboard you’ll find buttons to Create a new recurring charge and Upload Excel to upload a list of recurring charges.

If you add subscribers’ email addresses to the Excel file, the Tilopay Admin Dashboard will email them a subscription notification.

How do I create a plan in Subscription Billing? — screen 95
Form fieldExplanationRequired field
TitleEnter the name or title you want to give this recurring billing plan.
Plan descriptionYou can enter the plan details so your customers know what it includes.
FrequencySpecify how often the subscriber’s card will be charged.

If you don’t select an option, the frequency will be Daily.
Yes
CurrencySelect the currency you want to charge based on your payment method settings.Yes
Initial payment amountIf you want to charge customers an initial amount when they purchase this plan, enable it here.

If you leave it at zero (0), your customer won’t be charged anything.
Failed payment attempts per dayChoose how many times per day Tilopay can retry charging your customer if a payment fails.

If you don’t select a number, Tilopay will only attempt to charge your customer once (1) per day.
Recurring Charge AmountEnter the amount you’ll charge your customer.
AmountSpecify the amount you’ll charge customers who choose this plan based on the frequency you selected.Yes
How do I create a plan in Subscription Billing? — screen 97
Form fieldExplanationRequired field
1. Allow different options with different pricesYou can add multiple options for your customers to choose from.

Each option will have its own name and amount
Yes
2. Enable free trialEnable this option and specify how many days customers can use the free trial.Yes
How do I create a plan in Subscription Billing? — screen 98
Form fieldExplanationRequired field
3. Optional informationYou can add multiple options for your customers to choose from.

Each option will have its own name and amount
a. Number of allowed renewalsEnable this option and specify how many days customers can use the free trial.Yes
b. End dateThis lets you set the date when recurring billing ends.

If you leave it blank, there will be no end date.
How do I create a plan in Subscription Billing? — screen 99
Form fieldExplanationRequired field
c. Redirect URL when canceling the process (GET method)
Thank-you URLUse this if you want to send the customer to a custom URL thanking them for subscribing
Redirect URL when canceling the processUse this if you want to redirect the customer to a URL when they cancel their subscription.
How do I create a plan in Subscription Billing? — screen 100
Form fieldExplanationExample
d. Webhook URL (POST method) (Optional fields)
Successful registration webhook URLHere you can enter a webhook URL to receive the callback when a customer successfully purchases a subscription.{'id_plan' : 1, 'email' : 'email@email.com', 'modality' : 'ModalityName', 'amount' : 25, 'frequency' : '', 'coupon' : '5HT5W8YT', 'free_trial' : 1, 'next_payment_date' : '2023-02-25'}.
Redirect URL when canceling the processHere you can enter a webhook URL to receive the callback when the customer is successfully charged.{'id_plan' : 1, 'email' : 'email@email.com', 'amount' : 25, 'auth' : '123456', 'orderNumber' : 'PRE123456'}.
Declined payment webhook URLHere you can enter a webhook URL to receive the callback when a payment fails.{'id_plan' : 1, 'email' : 'email@email.com', 'amount' : 25}.
Subscription cancellation webhook URLEnter a webhook URL to receive the callback when a customer cancels a subscription to one of the plans they purchased.{'id_plan' : 1, 'email' : 'email@email.com', 'expire' : '2023-02-25'}.
Subscription reactivation webhook URLHere you can enter a webhook URL to receive the callback when a customer reactivates a subscription to one of their plans.{'id_plan' : 1, 'email' : 'email@email.com', 'next_payment_date' : '2023-02-25'}.
How do I create a plan in Subscription Billing? — screen 101

Need help with this guide?

Our team can support you through the integration.

Technical Support

Was this article helpful?