Skip to main content
knowledgecenter.avangate.com

Instant Notification Service (INS)

Note to user NOTE:  Instant Notification Service (INS) is available only to merchants upgraded from 2Checkout 1.0.

Overview

You can use the Instant Notification Service (INS) to automate order management processes by accepting order information via web posts. The INS is a service which will post sets of parameters to any URL you specify. Each post represents a message containing all the information you need about a specific event (such as when a recurring order re-bills successfully).

How can I use INS?

Use INS to automate back-end functions, including but not limited to:

  • Creating end user accounts
  • Providing access to acquired services
  • Fulfilling purchases
  • Tracking orders and customers
  • Engaging customers

How does INS work?

  1. Create one or multiple INS listener pages on your website. 
  2. Configure the INS settings of your 2Checkout account to point to the URLs of your default/preferred listener pages.
  3. Set up multiple URLs if you require more listener pages, such as in testing scenarios in which you don’t want to use your default INS listener. 
  4. 2Checkout sends webhook notifications to the endpoints you defined when shoppers acquire products/services from your online store. 2Checkout packages the content information and sends it using secure (HTTPS) POST, according to your INS settings.
  5. 2Checkout sends the INS parameters according to your setup from INS Settings. To customize the information available in the notifications, check the parameters from the INS settings page. Learn more about INS parameters here.
  6. 2Checkout uses a HMAC_MD5 signature to validate the HTTPS POST. Calculate the signature using data sent and your 2Checkout account’s secret key, following the instructions included in this article.
  7. Your custom INS listener scripts consume the notifications and process the info received.
  8. Configure your INS listeners to output a read receipt confirmation in the listener page after receiving a valid INS message. This article includes guidance on how to generate the confirmation.
  9. In the absence of a confirmation from one of your INS listeners, 2Checkout continues to send notifications to that endpoint, according to the failure retry process, until you provide a valid response.
  10. In the eventuality that 2Checkout fails to send INS or doesn’t receive a confirmation from your INS listener, it displays an error in your Control Panel, on the Dashboard.

Set up INS endpoints

  1. Login into your 2Checkout account.
  2. Navigate to INS settings under System settings.
  3. Click on Add endpoint to add a new URL configuration that will receive the notifications.
  4. Save your settings.

You can set up multiple endpoints for your INS notifications, for scenarios in which you have multiple Internal System that require to receive this information. You can add an unlimited number of endpoints that will receive notifications.

Debug INS

To view or debug INS notifications during the integration phase, place TEST orders.

Alternatively, search for specific orders in the "Orders & Reports" area. When you access the order details page you get the option to resend notifications. You can also see how many INS notifications have been sent so far for an order. Opt to reissue the INS for debug and 2 re-generates and re-sends the INS, but also displays a copy of the content sent in the control panel.

Secure your INS script

For security reasons, 2Checkout recommends that you restrict access to the INS script.