Skip to main content
knowledgecenter.avangate.com

IPN and LCN URL settings

Overview

Avangate can send Instant Payment Notifications (IPN) and License Change Notifications (LCN) to alternative URLs, not just the defaults. This article offers guidance on how to set up multiple URLs to scripts on your server capable of handling Avangate nofications.

Availability

All Avangate accounts. 

How it works

The Avangate system sends out notifications (IPNs and LCNs) to the URLs that you can configure in the URL areas under:

  1. IPN settings (https://secure.avangate.com/cpanel/ipn_settings.php)
  2. LCN settings (https://secure.avangate.com/cpanel/ipn_settings.php)
  3. Both IPN and LCN (https://secure.avangate.com/cpanel/notification_urls.php)

Requirements

Enter valid URLs for both IPN and LCN when editing URL configurations.

Default IPN and LCN URLs 

IPN

  1. Navigate to IPN settings (https://secure.avangate.com/cpanel/ipn_settings.php).
  2. Enter the URL where the Avangate system will send out Instant Payment Notifications (IPNs).
  3. The settings will automatically be reflected under the default URL notification configuration for your account.
  4. Changes to the IPN URL in the IPN settings area reflect under the default URL notification configuration for your account.

LCN

  1. Navigate to LCN settings (https://secure.avangate.com/cpanel/ipn_settings.php).
  2. Enter the URL where the Avangate system will send out License Change Notifications (LCNs).
  3. The settings will automatically be reflected under the default URL notification configuration for your account.
  4. Changes to the LCN URL in the LCN settings area reflect under the default URL notification configuration for your account.

Default URL configuration 

  1. Navigate to the Notification URLs area (https://secure.avangate.com/cpanel/notification_urls.php).
  2. Edit the Default URL configuration.
  3. Enter URLs for both IPN (mandatory) and LCN notifications (mandatory) and Save.
  4. The settings automatically reflect under the IPN URL in the IPN settings area and the LCN URL in the LCN settings area.
  5. Changes to the default URL notification configuration for your account reflect under the IPN URL in the IPN settings area and the LCN URL in the LCN settings area.
  6. Click Reset to revert a URL configuration to the last saved state.

Custom IPN and LCN URLs 

  1. Navigate to the Notification URLs area (https://secure.avangate.com/cpanel/notification_urls.php).
  2. Click the New URL configuration button.
  3. Enter a parameter value. You will use this parameter in Buy Links for new purchases, manual subscription renewals and upgrades, controlling the URLs used by the Avangate system to send IPN and LCN notifications. Read below for instructions.
  4. Enter URLs for both IPN (mandatory) and LCN notifications (mandatory) and click Save.
  5. The settings reflect under the IPN URL in the IPN settings area and the LCN URL in the LCN settings area.
  6. Changes to the default URL notification configuration for your account reflect under the IPN URL in the IPN settings area and the LCN URL in the LCN settings area.
  7. Click Reset to revert a URL configuration to the last saved state.
How do I get Avangate to send IPNs and LCNs to URLs other than the default links set?

Use the:

  • Parameter value specified for each new URL configuration.
  • And the NOTIFICATION_URL parameter in Buy Links (for new purchases, manual subscription renewals and upgrades).

For example, let's assume that you created a URL configuration with the following settings:

Parameter value:

MYTESTNOTIFICATIONS

IPN URL:

http://www.MyDomain.com/ipn_response.php

LCN URL:

http://www.MyDomain.com/lcn_response.php

 

And that you're using this Buy Link:

https://secure.avangate.com/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=2

You need to insert NOTIFICATION_URL=MYTESTNOTIFICATIONS into the Buy Link:

https://secure.avangate.com/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=2&NOTIFICATION_URL=MYTESTNOTIFICATIONS

 

IPN and LCN HASH 

Default URLs for IPN and LCN

IPN HASH = HMAC_MD5 signature calculated from IPN_PID[0], IPN_PNAME[0], IPN_DATE and DATE and the Secret key for your account for notifications sent to the default URL parameters configured for your account.

LCN HASH = HMAC_MD5 signature calculated using the secret key for your account and the values received for LICENSE_CODE, EXPIRATION_DATE, DATE and the Secret key for your account for notifications sent to the default URL parameters configured for your account.

Custom IPN and LCN configurations

IPN HASH = HMAC_MD5 signature calculated from IPN_PID[0], IPN_PNAME[0], IPN_DATE and DATE and the system-generated secret keys when custom URL configurations are used.

LCN HASH = HMAC_MD5 signature calculated using the values received for LICENSE_CODE, EXPIRATION_DATE, DATE and the system-generated secret keys when custom URL configurations are used.

Where can I find the secret key?

Custom IPN and LCN URL 

1.Navigate to the Notification URLs area (https://secure.avangate.com/cpanel/notification_urls.php).

2. Click the New URL configuration button or the Edit button of one of the existing URL configurations.

3. The system-generated secret key valid for each URL configuration respectively is available in the IPN/LCN secret key field.

What notifications are sent to the URLs set through the NOTIFICATION_URL parameter and for what triggers?

The IPN and LCN notifications for the initial purchase, as well as for the subsequent renewals of the subscriptions generated for this order and for any future upgrades will be sent to the IPN and URL parameters

 

Trigger

IPN

LCN

Non-default URLs set using NOTIFICATION_URL

New purchase/order of a subscription

YES

YES

YES

Manual renewal of subscription

YES

YES

YES

Automatic subscription renewal

YES

YES

YES

Subscription upgrade

YES

YES

YES

 

What is the default value of NOTIFICATION_URL?

Include NOTIFICATION_URL=DEFAULT (case sensitive) to send IPN and LCN notifications to the default URLs you configure.

Is the value of the parameter saved on each order and subscription?

The custom values of the NOTIFICATION_URL parameter used are saved on orders and subscriptions.

What happens with future notifications if I used the NOTIFICATION_URL parameter?

All future LCN and IPN notifications for future renewals and upgrades of current subscriptions for which a NOTIFICATION_URL value was used will be sent to the URLs configured for that value.

What happens if I change the value for a parameter used?

All future LCN and IPN notifications for renewals and upgrades of current subscriptions for which a NOTIFICATION_URL value was used will be sent to the default URLs configured for your account.

What happens if I change the custom URLs for a configuration?

All future LCN and IPN notifications for renewals and upgrades of current subscriptions for which a NOTIFICATION_URL value was used will be sent to the new URLs configured.

FAQ

Can I use multiple values for this parameter and send IPNs and LCNs to more than one URL each?

This parameter supports a single value for the time being.

Is this parameter available for network cross-selling orders through the Avangate system?

No, the parameter will only work for your account.

Does this parameter work for partner and API orders?

This functionality is not supported for the time being.