Revision as of 09:52, 10 December 2010

We have prepared a video tutorial for this section @ http://www.whmcs.com/tutorials.php?i=3

Instant Payment Notification (IPN)

For PayPal invoices to be automatically marked paid when you receive a payment you need to enable IPN inside your PayPal account. This is done in the My Account > Profile -> Instant Payment Notification Preferences (under Selling Preferences) area. It's not important what URL you use so set it to your system url eg. http://www.yourdomain.com/whmcspath/ Then select the "Enabled" option.

PayPal Subscriptions

Unless disabled in the PayPal gateway config, when a user views an invoice for a recurring product or service they will be shown a PayPal Subscribe button. This allows the user to subscribe so that their payment for that product or service is sent to you automatically each month and automatically applied to the invoices. There are two conditions that must be met before the PayPal subscribe button will appear:

1. The invoice's Due Date must be in the future.
2. The products in the invoice must be recurring (ie. domains and billable items won't generate subscriptions).

Modify Subscriptions

By enabling Modify Subscriptions, customers will be given the option to create a new agreement or modify an existing one when going through the subscribe process. Saving you from having to cancel a subscription and create a new one.

When a client upgrades/downgrades modifying of the subscription does not occur at the time of the upgrade, it occurs on the next renewal invoice (when the client logs in to pay the new amount).

Due to limitations of PayPal's system, when modify is enabled, they ignore trial period amounts therefore prorata and promos can't be used.

Automated Refunds

As of version 4, you can issue refunds for PayPal payments directly from within WHMCS. Before you can do this however, you need to setup PayPal API access. The steps for doing this are as follows:

• Login to PayPal
• Go to Profile > API Access
• Choose Option 2 - Request API credentials to create your own API username and password.

• Choose Option 1 - Request API Signature and click Agree and Submit

• Copy the username, password and signature that get provided and then click Done
• Enter the details from the previous step into the WHMCS Payment Gateways config screen where requested

You will now be able to enter a refund and have it sent from PayPal at the same time from within the WHMCS admin area invoice management screen.