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.

Setting Up IPN Notifications on PayPal

After you implement and test your IPN listener, you identify the listener to PayPal by selecting Instant Payment Notification Preferences from your account's profile. You then specify your listener's URL and click the box to activate it.

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. Click Profile on the My Account tab.
  2. Click Instant Payment Notification Preferences in the Selling Preferences column.
  3. Click Choose IPN Settings to specify your listener's URL and activate the listener. The following screen appears:

  4. Specify the URL for your listener in the Notification URL field.
  5. Click Receive IPN messages (Enabled) to enable your listener.
  6. Click Save. The following screen appears:

  7. 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 will always be sent to your notification URL unless receiving IPNs have been disabled. 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 or not to resend them.