# Identifying your IPN listener to PayPal (/api/nvp-soap/ipn/IPNSetup)



> **Note:** **Important:** NVP/SOAP is a legacy integration method. We accept new integrations and support existing integrations, but there are newer solutions. If you're starting an integration, [we recommend our latest solutions](/).

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](#setting-up-ipn-notifications-on-paypal)
* [Dynamically Setting the Notification URL](#dynamically-setting-the-notification-url)

## Setting Up IPN Notifications on PayPal [#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:** **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](https://www.paypal.com).
2. Hover over your name and then click **Account Settings** from the dropdown menu.
3. On the **Notifications** page, click the **Update** link for the **Instant payment notifications** item.
4. Click **Choose IPN Settings** to specify your listener's URL and activate the listener.
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**.

You can return to the **Instant Payment Notification** page to modify your notification URL, disable your listener, or turn off IPN.

## Dynamically Setting the Notification URL [#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:** **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.