A Quick Introduction

PayPal Manager provides common functions and configuration for PayPal integration across an entire website. PayPal Manager does very little on its own - it can generate payment buttons, record transactions, and perform automatic notification. Other managers build on these functions to meet their specific needs.

Configuring Your PayPal Account

Create a PayPal account and set some profile settings. At a minimum, in your profile, under selling preferences, setup the following:

• set the sales tax settings
• Enable Instant Payment Notification (IPN) with a notification URL of http://www.<domainname>/paypalmanager/paypal_ipn_fulfill.cgi
• Under website payment preferences, Turn on Auto-return
• enter http://www.<domainname>/paypalmanager/paypal_return_status.cgi as the Return URL
• turn on Payment Data Transfer
• record your identity token

Set the LOCAL_PAYPALMANAGER_IPN_IDENTITY_TOKEN map to the identity token given by PayPal.

Return URL Requirements: The following items are required in order to set up Auto Return from PayPal.

• Per the user agreement, there is some required verbiage that goes on the Return URL that will help the buyer understand that the payment has been made and that the transaction has been completed.
• You must explain that payment transaction details will be emailed to the buyer.

Example: Thank you for your payment. Your transaction has been completed, and a receipt for your purchase has been emailed to you. You may log into your account at www.paypal.com/us to view details of this transaction.

Note: One script the user returns to is just a "status/informational script". This is the paypal_return_status.cgi. The other script, paypal talks to and records information. This is the Instant Payment Notification script called paypal_ipn_fulfill.cgi. Because some transactions can be pending, this script can be accessed, minutes/hours/days later!

Configuring PayPal Manager

PayPal Manager requires some minor configuration before it is ready to be used. It requires an IPN identity token, which authorizes the automatic notification system with PayPal. It also requires email alert configuration.

There are two email addresses that need to be configured. The admin email is the address of the administrator, and is also the username of the PayPal account which payments will go to. This address will get notifications when a payment fails, or similar issues. The system email is the address these notifications come from.

• LOCAL_PAYPALMANAGER_ACCOUNT_EMAIL - The email address of the PayPal account that transactions will be sent to - additionally, all automatic payment notifications will go to this email address
• LOCAL_PAYPALMANAGER_ACCOUNT_NAME - Name of administrator
• LOCAL_PAYPALMANAGER_SYSTEM_EMAIL - Notification system email address - the recommended value for this map is do-not-reply@yourdomain.com, configured with an "out of office" notification that mail sent to this address is not monitored
• LOCAL_PAYPALMANAGER_SYSTEM_NAME - Name of notification system. Note: Avoid using "Paypal" in this map due to it raising the likelihood of emails getting caught in spam folders.
• LOCAL_PAYPALMANAGER_IPN_IDENTITY_TOKEN - Unique PayPal identification token, used for secure automatic notifications

PayPal Donation Drives

PayPal Manager supports the ability to run an automatically managed donation drive. Simply set the LOCAL_PAYPALMANAGER_CURRENT_DONATION_DRIVE map to a unique identifier for your donation drive. You may then include the final donation drive on a template with the following tag:

:::DONATION_DRIVE:ARGS: goal=>100000&template=donation_drive_progress_bar :::

Within the donation_drive_progress_bar template, the current state of the donation drive is provided through the :::current_donation_progress_percent:::, :::current_donation_progress:::, and :::donation_target::: tags.

PayPal Manager Payments

PayPal Manager provides a generic :::PAYPAL::: payment field tag that forms the framework for all kinds of payment. PayPal Manager handles automated payments through an acronym system. Handling for the acronyms 'donation' and 'balance' are automatically provided. Other managers automatically provide handling for additional acronyms. Whenever there is an error or other notification, it is emailed to the PayPal account email address.

For instance, the following tag will add a simple donation button to your website: :::PAYPAL:ARGS: acronym=donation&amount=5.00 :::. Whenever a user donates to your website, PayPal Manager will send an email notification to the PayPal account email address.

PayPal Here Payments

Paypal Manager now works with Paypal Here payments. Since there is currently no way to input a value that links a payment to a LunpaCMS user account, paypalmanager collects all paypal here payments for an admin to sort later. To assign the payments, go to the paypal here page and select the user that it should be assigned to, enter a memo and whether the user should have a charge added to counterbalance the payment. The charge would not be necessary, for instance, if the user is paying for registration or membership fees that have already been charged to their account.

Transactions Requiring Attention

Sometimes PayPal transactions are not automatically linked to users for various reasons. An administrator needs to confirm the details of those transactions and link them to appropriate users from Transactions Requiring Attention page. Below steps are a sample instruction to link a transaction to a user.

1. Go to Transactions Requiring Attention page in PayPal Manager under Modules group.
2. Expand the transaction and confirm the details of the transaction.
3. Click "Apply to a User."
4. Choose the appropriate user, then click "Select and Continue to Add Transaction Form."
5. Select the appropriate actions to take for payment (for example, set it to extends membership by one year and check "Send Balance Notification Email", etc.).
6. Click "Add New Transaction"

In case when it complains an error because the user never applied for a membership, do the followings:
  - Edit the user's profile to mark him or her as a member, with all three dates set to today.
  - Add a transaction for "Membership Application Charge", debit $10 (Annual membership fee amount).
  - Resubmit credit transaction per #6.
  - Review the user's profile to make sure his or her state is correct.