Identifying Your IPN Listener to PayPal

After you implement and test your IPN listener, you make your listener known to PayPal by specifying the listener's URL in your account's profile. Optionally, you can override the URL to specify another listener for specific payments.

Important: Use HTTPS to post messages back to PayPal for verification. PayPal no longer supports HTTP for post backs. For full details, see the IPN Verification Postback to HTTPS Microsite.

Setting Up IPN Notifications on PayPal

The following procedure describes how to specify and activate the URL for your IPN listener in your PayPal profile.

Your listener must be located at the URL that you specify in the profile. Before you activate your listener on PayPal, you should test the listener using the IPN simulator in the Sandbox.

The steps to set up your listener for Sandbox testing and to set up your listener for live operation on PayPal are the same. The only difference is that you log into the Sandbox to set up your listener for Sandbox testing and you log into PayPal to set up your listener for live operation.

Note: Sandbox testing goes beyond simply using the IPN simulator. The IPN simulator only sends IPN messages to a listener; it does not perform the complete operation; for example, it does not complete a transaction. Sandbox testing involves performing the same actions in the Sandbox as you expect to be performed when the listener goes live.

After you log in, follow these instructions to set up your listener:

  1. Log in to your PayPal business account at www.paypal.com.

  2. Click the profile icon (Profile menu) on the top right side of the page. From the Business Profile menu, select Profile and Settings, then select My selling tools.

    Note: If you do not see the profile icon on the top right, navigate to My Account > Profile > My Selling Tools.

  3. Click the Update link in the Instant payment notifications row, in the Getting paid and managing my risk section.

  4. Click Choose IPN Settings to specify your listener's URL and activate the listener. The following page opens:

  5. Specify the URL for your listener in the Notification URL field.

  6. Click Receive IPN messages (Enabled) to enable your listener.

  7. Click Save. The following page opens:

  8. Click Back to Profile Summary to return to the Profile after activating your listener. You also can click Edit settings to modify your notification URL or disable your listener. You can click Turn Off IPN to reset your IPN preferences.

Dynamically Setting the Notification URL

You can specify an IPN listener for a specific payment; this is the only way to receive IPNs associated with Adaptive Payments. In this case, PayPal sends the IPN message to the listener specified in the notification URL for a specific button or API operation instead of the listener specified in your Profile.

To specify a notification URL:

For a/an ... specify your IPN Listener's URL in the ...
PayPal Payments Standard button notify_url HTML form variable
NVP API operation NOTIFYURL field of the DoDirectPayment, DoExpressCheckoutPayment, or DoReferenceTransaction request
SOAP API operation NotifyURL field of the DoDirectPayment, DoExpressCheckoutPayment, or DoReferenceTransaction request
Adaptive Payments API operation ipnNotificationUrl field of the Pay or Preapproval request

Note: The IPN message is always sent to your notification URL unless you have disabled the preference to receive IPN messages. Even though you have not enabled receiving IPN messages in your Profile or you have reset your preference by turning off IPN messages, PayPal still sends IPN messages to the notification URL you specify for a specific payment. IPN messages not sent because you disabled the preference in your Profile will appear in the IPN history when you enable receiving IPNs. After they appear in the history, you can choose whether to resend them.