Paypal - How to integrate Paypal Subscription with QLM – Soraco Technologies

QLM 8.1 supports PayPal subscriptions. To set up a subscription-based product in PayPal, follow the steps below:

QLM uses Paypal Instant Payment Notifications (IPN) to automate the license key generation process and subscription renewal. The first step in setting up the integration is to configure the Paypal IPN to point to the QLM License Server.

Log in to your PayPal account
In the Settings menu, select Account Settings
In the Notifications section, locate the Instant payment notifications section
Click Update
Click Choose IPN Settings
In the Notification URL field, enter (update the URL to point to your QLM License Server): https://qlm3.net/qlmdemo/qlmLicenseServer/qlmpaypalipn.aspx
Check the option Receive IPN messages (Enabled)
Click Save

In QLM, make sure that Paypal is enabled. To do so:

Launch the QLM Management Console
Go to the Manage Keys tab
Click 3rd Party Extensions
Select Paypal and check the Enabled box.
Optionally but preferably, configure a User/Password combination. The password should not contain special characters (!?/\).
Click Ok

Next, you need to create a button that your customers can use to purchase your product.

Logon to your PayPal account
In the Profile menu, select My Selling Tools
In the Selling online section, select Paypal buttons / Update
Click Create new button
Set the button type to: Subscriptions
Set the item name as your product name
Select your currency
Enter a billing amount per cycle
Specify your billing cycle
Expand the Step 3 panel
In the Advanced variables section, check Add advanced variable and enter the following in the field: custom=&is_productid=1&is_majorversion=2&is_minorversion=0&is_features=0:1;1:3&is_licensemodel=subscription&is_emailtemplate=Paypal.NewSubscription&is_emailtemplate_renew=Paypal.RenewSubscription&is_user=<user>&is_pwd=<pwd>

Replace the values for is_productid, is_majorversion, is_minorversion and is_features with the values of your choice.

Replace the values of <user> and <pwd> with the user/password combination created in the QLM Management Console / 3rd Party Extensions. If you did not specify a user/pwd, remove the is_user/is_pwd arguments from the custom variable above.

Click Create button
Go back to the My Saved Buttons page
Next to your product, click the Action dropdown and select View code
Copy the code and paste it on a page on your web site.

You can customize the email template to use when sending an email to the customer. To customize the email template, add the is_emailtemplate argument as shown above. The email template can be created from the QLM Management Console / Manage Keys / Email Templates. For example, if you create a template in the QLM Templates Editor called NewOrder, set the is_template as follows: &is_emailtemplate=NewOrder

The email template can contain any PayPal variable such as %payer_email% or %ProductName%.

QLM 9.0.16228.1+ includes 4 Paypal specific templates: Paypal.NewOrder, Paypal.NewSubscription, PayPal.RenewSubscription and Paypal.CancelSubscription.

To test the subscription:

Go to the page on your site that has the button created earlier
Click the button
A license key will be generated and emailed to the customer
Upon renewal of the subscription, the QLM Subscription Expiry date will be automatically updated.

For details on how to support subscriptions in your application, check this article.

For a list of Paypal's subscription variables, check this article.

Note: In order to support accented characters in customers' names or postal addresses, make sure that you configure PayPal to handle UTF-8 as described in this article.