EasyEstimates created and licensed by Sizzling Web Design
PayPal IPN Management
PayPal's Instant Payment Notification (IPN) enables PayPal to automatically update the EasyEstimates database with current payment status for each order and related information such as the PayPal transaction ID and the amount in fees charged by PayPal. EasyEstimates also allows emails to be sent to the customer when the payment status changes.
To enable use of PayPal IPN, it is necessary to enable IPN within your PayPal profile, add a few line to the PayPal form, and specifiy the which PayPal account to use within EasyEstimates. These are explained in more detail below.
To enable sending of customer emails when payment status changes occur, it is necessary to use an email template to define the general layout of the email. A sample, eeipnemail.tpl, is available for use. It is also necessary to define the subject line for the emails and text within the emails. Only payment statuses and pending reasons that you wish to have emails sent need to be defined.
To enable PayPal IPN:
1) Logon to your PayPal account
2) Click the Profile tab, under Selling Preferences, click "Instant Payment Notification Preferences".
3) Click the checkbox to enable IPN and enter you web site URL and directory and eepaypalipn.php in the area provided. For example: http://www.mywebsite.com/mydirectory/eepaypalipn.php
4) Both easyestimatepage.php and easypreviewpage.php contain sample PayPal form with instructions. If you're an existing EasyEstimates and PayPal User, you will need to add the "custom" line to the form and can add the "notify_url" line.
| PayPal Business ID | This is the ID you use to sign on to your PayPal account. This is usually also an email address. |
| PayPal Currency Code | The currency in which you accept payments in PayPal. If this is left blank, it will default to USD for U.S. Dollars. |
| PayPal IPN Email Template | EasyEstimates can automatically send an email to your customer to notify them when a payment event, such as a payment is pending or a payment completed. This template is used to format the email. Although all the automated payment status emails must use the same template, the email subject and a message area, %statusmsg%, within the email can be specific to the pending reason or payment status. |
| PayPal IPN php Call | This parameter enables calling a user supplied program from within the IPN processing. The program is called if this field has a value.
The parameters passed to the the program are:
|
| Code Value | Code Description |
| Canceled-Reversal | A reversal has been canceled. For example, you won a dispute with the customer, and the funds for the transaction that was reversed have been returned to you. |
| Completed | The payment has been completed, and the funds have been added successfully to your account balance. |
| Denied | This happens only if the payment was previously pending because of possible reasons described in Pending Reason. |
| Failed | The payment has failed. This happens only if the payment was made from your customer's bank account. |
| Partially-Refunded | The transaction has been partially refunded. |
| Pending | The payment is pending. See pending reason for more information. |
| Refunded | You refunded the payment. |
| Reversed | A payment was reversed due to a chargeback or other type of reversal. The funds have been removed from your account balance and returned to the buyer. The reason for the reversal is specified in the ReasonCode. |
| Code Value | Code Description |
| address | The payment is pending because your customer did not include a confirmed shipping address and your Payment Receiving Preferences is set to allow you to manually accept or deny each of these payments. To change your preference, go to the Preferences section of your PayPal Profile. |
| echeck | The payment is pending because it was made by an eCheck that has not yet cleared. |
| intl | The payment is pending because you hold a non-U.S. account and do not have a withdrawal mechanism. You must manually accept or deny this payment from your PayPal Account Overview. |
| multi-currency | You do not have a balance in the currency sent, and you do not have your Payment Receiving Preferences set to automatically convert and accept this payment. You must manually accept or deny this payment. |
| other | The payment is pending for a reason other than those listed above. For more information, contact PayPal Customer Service. |
| unilateral | The payment is pending because it was made to an email address that is not yet registered or confirmed. |
| upgrade | The payment is pending because it was made via credit card and you must upgrade your account to Business or Premier status in order to receive the funds. upgrade can also mean that you have reached the monthly limit for transactions on your PayPal account. |
| verify | The payment is pending because you are not yet verified. You must verify your account before you can accept this payment. |