{"id":27,"date":"2013-09-30T12:24:00","date_gmt":"2013-09-30T12:24:00","guid":{"rendered":"http:\/\/128.199.168.137\/?p=27"},"modified":"2021-03-02T21:36:22","modified_gmt":"2021-03-02T16:06:22","slug":"introducing-instamojo-webhooks","status":"publish","type":"post","link":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/","title":{"rendered":"Introducing Instamojo Webhooks"},"content":{"rendered":"
\n
\n
One of our primary goals has been to bring simplicity to online selling. While at it, there\u2019s a part which involves us hiding the complexities while giving a simple set of features which helps you maximize sales.<\/div>\n
On the same chord, today we are excited to introduce Instamojo Webhooks<\/strong>.<\/div>\n
\u00a0<\/strong><\/div>\n

Webhooks FAQ
\n<\/strong><\/h2>\n

Q. What are Webhooks?<\/strong><\/h3>\n
<\/div>\n
Webhooks are real time notifications that alert you whenever an automated event like successful transaction\u00a0occurs in our system.<\/div>\n
<\/div>\n
In technical terms, after every successful transaction, Instamojo can optionally issue a server-side call to your server. This server-side call is implemented as a standard POST request. We include some data about the payment in this call as the POST request payload.<\/div>\n
<\/div>\n

\u00a0Q. How is it different from Redirection?<\/strong><\/h3>\n
<\/div>\n
In \u2018custom redirect<\/strong>‘ you can simply redirect the buyer to any website\/URL that you wish, with only the transaction_id passed as GET variable.\u00a0This\u00a0URL<\/span>\u00a0can be specified while adding or editing the offer (under the \u201cadvanced settings<\/em>” section).<\/div>\n
<\/div>\n

Using \u2018webhook<\/strong>\u2019, you can issue a call to your server with a list of key variables with all transaction details. The data is sent as POST variables.<\/p>\n

The Webhook and Custom URLs can be different and you can use both the features independently.<\/p>\n

For custom redirect, only a URL has to be specified in offer details, while webhook feature needs some integration for the seller after specifying the Webhook URL<\/a> (screenshot below<\/em>).<\/p>\n<\/div>\n

\n

 <\/p>\n

So with Webhook, Instamojo now elegantly offers the functionality of sending information to your server after every successful purchase.<\/p>\n<\/div>\n

Q. How can the Webhook feature benefit me?<\/strong><\/h3>\n

 <\/p>\n

\u00a0Webhook feature has a lot of practical day-to-day applications. Here are some use-cases where it can be used:<\/span><\/div>\n
\n

1. Sending a custom email from your server at the end of every successful transaction<\/p>\n

2. Activation of a user\u2019s account on your service<\/p>\n

3. Sending a user the license key to your software<\/p>\n

4. Adding a user to your CRM software<\/p>\n

5. Adding the transaction to your accounting software<\/p>\n<\/div>\n<\/div>\n

For geeks\/programmers\/alike (optional)<\/strong>:
\n
\n<\/strong><\/p>\n
\n

Q. How is the Message Authentication Code generated?\u00a0<\/strong><\/h3>\n

We create a list of all values from the key-value pairs we\u2019re about to send in the POST request and sort them in the order of their keys. We then concatenate all these values together, separated by a pipe (|) character. We then use the HMAC-SHA1 algorithm to generate the signature. The HMAC key for the signature generation is the secret salt from the user\u2019s profile (please contact\u00a0support@instamojo.com<\/a>\u00a0to share the\u00a0URL<\/span>\u00a0to which you would like the POST request to be sent to and to gain access to your secret salt<\/em>).
\n
\n<\/em><\/p>\n

Q. How is the Message Authentication Code useful and do I need to use it?\u00a0<\/strong>
\n<\/em><\/h3>\n
<\/div>\n
The Message Authentication Code for the payload is what you can use to verify that the POST request is indeed sent by Instamojo, versus someone else trying to impersonate Instamojo and\/or gain access to your data\/systems.<\/div>\n
You don\u2019t strictly need to use it since the data is sent in plain text, and therefore readable without verifying the MAC, it is a good idea to verify the MAC to ensure the integrity and authenticity of the POST request.<\/div>\n
<\/div>\n

In short, using MAC is optional, but recommended as a security feature.
\n
\nSample code in Python<\/strong><\/h4>\n
\n
import hmac\r\nimport hashlib\r\n\r\n# 'd' is the dictionary that corresponds to the POST request\r\n# 'salt' is the key for the HMAC algorithm\r\n\r\nmac_provided = d.pop(mac)\r\n\r\nmessage = '|'.join(str(i) for i in zip(*sorted(d.iteritems()))[1])\r\nmac_calculated = hmac.new(salt, message, hashlib.sha1).hexdigest()\r\n\r\nif mac_provided == mac_calculated:\r\n    # MAC is authenticated, proceed with fulfillment\r\nelse:\r\n    # MAC authentication failed, deny fulfillment, inform Instamojo\r\n\r\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n
For more detailed information about our Webhooks, please visit our support center here<\/a>. And as always, we would love to get your feedback at support@instamojo.com<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"One of our primary goals has been to bring simplicity to online selling. While at it, there\u2019s a…\n","protected":false},"author":6,"featured_media":4680,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[7],"tags":[334,335,336],"yoast_head":"\nIntroducing Instamojo Webhooks - Instamojo E-commerce Blog<\/title>\n<meta name=\"description\" content=\"Introducing Instamojo Webhooks. Webhooks are real time notifications that alert you when an automated event like successful transaction occurs in our system\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Introducing Instamojo Webhooks - Instamojo E-commerce Blog\" \/>\n<meta property=\"og:description\" content=\"Introducing Instamojo Webhooks. Webhooks are real time notifications that alert you when an automated event like successful transaction occurs in our system\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog Instamojo\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/Instamojo\" \/>\n<meta property=\"article:author\" content=\"facebook.com\/instamojo\" \/>\n<meta property=\"article:published_time\" content=\"2013-09-30T12:24:00+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-03-02T16:06:22+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2013\/09\/webhooks.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1150\" \/>\n\t<meta property=\"og:image:height\" content=\"581\" \/>\n<meta name=\"twitter:card\" content=\"summary\" \/>\n<meta name=\"twitter:creator\" content=\"@instamojo\" \/>\n<meta name=\"twitter:site\" content=\"@instamojo\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Instamojo\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/#organization\",\"name\":\"Instamojo\",\"url\":\"https:\/\/www.instamojo.com\/blog\/\",\"sameAs\":[\"https:\/\/www.facebook.com\/Instamojo\",\"https:\/\/www.instagram.com\/instamojo_india\/\",\"https:\/\/www.linkedin.com\/company\/instamojo\/\",\"https:\/\/www.youtube.com\/user\/instamojo\",\"https:\/\/in.pinterest.com\/instamojo\/\",\"https:\/\/twitter.com\/instamojo\"],\"logo\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/#logo\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2020\/10\/Instamojo-logo.png\",\"contentUrl\":\"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2020\/10\/Instamojo-logo.png\",\"width\":400,\"height\":92,\"caption\":\"Instamojo\"},\"image\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/#logo\"}},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/#website\",\"url\":\"https:\/\/www.instamojo.com\/blog\/\",\"name\":\"Blog Instamojo\",\"description\":\"eCommerce business growth blog\",\"publisher\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.instamojo.com\/blog\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2013\/09\/webhooks.png\",\"contentUrl\":\"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2013\/09\/webhooks.png\",\"width\":1150,\"height\":581},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#webpage\",\"url\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/\",\"name\":\"Introducing Instamojo Webhooks - Instamojo E-commerce Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#primaryimage\"},\"datePublished\":\"2013-09-30T12:24:00+00:00\",\"dateModified\":\"2021-03-02T16:06:22+00:00\",\"description\":\"Introducing Instamojo Webhooks. Webhooks are real time notifications that alert you when an automated event like successful transaction occurs in our system\",\"breadcrumb\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.instamojo.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introducing Instamojo Webhooks\"}]},{\"@type\":\"Article\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#webpage\"},\"author\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/#\/schema\/person\/42d2fa4635c87aa3a0e3665835f155a0\"},\"headline\":\"Introducing Instamojo Webhooks\",\"datePublished\":\"2013-09-30T12:24:00+00:00\",\"dateModified\":\"2021-03-02T16:06:22+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#webpage\"},\"wordCount\":580,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2013\/09\/webhooks.png\",\"keywords\":[\"Custom Redirect\",\"Instamojo Webhooks\",\"Webhook\"],\"articleSection\":[\"Updates\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#respond\"]}]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/#\/schema\/person\/42d2fa4635c87aa3a0e3665835f155a0\",\"name\":\"Instamojo\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.instamojo.com\/blog\/#personlogo\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/1ca6da28cc8b22fb742c790c96543ab9?s=96&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/1ca6da28cc8b22fb742c790c96543ab9?s=96&r=g\",\"caption\":\"Instamojo\"},\"description\":\"India's simplest D2C tech platform. Host your online store, create landing pages, or share payment links. Sign up for free.\",\"sameAs\":[\"http:\/\/instamojo.com\",\"facebook.com\/instamojo\",\"https:\/\/twitter.com\/instamojo\"],\"url\":\"https:\/\/www.instamojo.com\/blog\/author\/instamojo\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Introducing Instamojo Webhooks - Instamojo E-commerce Blog","description":"Introducing Instamojo Webhooks. Webhooks are real time notifications that alert you when an automated event like successful transaction occurs in our system","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/","og_locale":"en_US","og_type":"article","og_title":"Introducing Instamojo Webhooks - Instamojo E-commerce Blog","og_description":"Introducing Instamojo Webhooks. Webhooks are real time notifications that alert you when an automated event like successful transaction occurs in our system","og_url":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/","og_site_name":"Blog Instamojo","article_publisher":"https:\/\/www.facebook.com\/Instamojo","article_author":"facebook.com\/instamojo","article_published_time":"2013-09-30T12:24:00+00:00","article_modified_time":"2021-03-02T16:06:22+00:00","og_image":[{"width":1150,"height":581,"url":"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2013\/09\/webhooks.png","type":"image\/png"}],"twitter_card":"summary","twitter_creator":"@instamojo","twitter_site":"@instamojo","twitter_misc":{"Written by":"Instamojo","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Organization","@id":"https:\/\/www.instamojo.com\/blog\/#organization","name":"Instamojo","url":"https:\/\/www.instamojo.com\/blog\/","sameAs":["https:\/\/www.facebook.com\/Instamojo","https:\/\/www.instagram.com\/instamojo_india\/","https:\/\/www.linkedin.com\/company\/instamojo\/","https:\/\/www.youtube.com\/user\/instamojo","https:\/\/in.pinterest.com\/instamojo\/","https:\/\/twitter.com\/instamojo"],"logo":{"@type":"ImageObject","@id":"https:\/\/www.instamojo.com\/blog\/#logo","inLanguage":"en-US","url":"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2020\/10\/Instamojo-logo.png","contentUrl":"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2020\/10\/Instamojo-logo.png","width":400,"height":92,"caption":"Instamojo"},"image":{"@id":"https:\/\/www.instamojo.com\/blog\/#logo"}},{"@type":"WebSite","@id":"https:\/\/www.instamojo.com\/blog\/#website","url":"https:\/\/www.instamojo.com\/blog\/","name":"Blog Instamojo","description":"eCommerce business growth blog","publisher":{"@id":"https:\/\/www.instamojo.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.instamojo.com\/blog\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"ImageObject","@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#primaryimage","inLanguage":"en-US","url":"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2013\/09\/webhooks.png","contentUrl":"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2013\/09\/webhooks.png","width":1150,"height":581},{"@type":"WebPage","@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#webpage","url":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/","name":"Introducing Instamojo Webhooks - Instamojo E-commerce Blog","isPartOf":{"@id":"https:\/\/www.instamojo.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#primaryimage"},"datePublished":"2013-09-30T12:24:00+00:00","dateModified":"2021-03-02T16:06:22+00:00","description":"Introducing Instamojo Webhooks. Webhooks are real time notifications that alert you when an automated event like successful transaction occurs in our system","breadcrumb":{"@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.instamojo.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Introducing Instamojo Webhooks"}]},{"@type":"Article","@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#article","isPartOf":{"@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#webpage"},"author":{"@id":"https:\/\/www.instamojo.com\/blog\/#\/schema\/person\/42d2fa4635c87aa3a0e3665835f155a0"},"headline":"Introducing Instamojo Webhooks","datePublished":"2013-09-30T12:24:00+00:00","dateModified":"2021-03-02T16:06:22+00:00","mainEntityOfPage":{"@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#webpage"},"wordCount":580,"commentCount":0,"publisher":{"@id":"https:\/\/www.instamojo.com\/blog\/#organization"},"image":{"@id":"https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#primaryimage"},"thumbnailUrl":"https:\/\/www.instamojo.com\/blog\/wp-content\/uploads\/2013\/09\/webhooks.png","keywords":["Custom Redirect","Instamojo Webhooks","Webhook"],"articleSection":["Updates"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.instamojo.com\/blog\/introducing-instamojo-webhooks\/#respond"]}]},{"@type":"Person","@id":"https:\/\/www.instamojo.com\/blog\/#\/schema\/person\/42d2fa4635c87aa3a0e3665835f155a0","name":"Instamojo","image":{"@type":"ImageObject","@id":"https:\/\/www.instamojo.com\/blog\/#personlogo","inLanguage":"en-US","url":"https:\/\/secure.gravatar.com\/avatar\/1ca6da28cc8b22fb742c790c96543ab9?s=96&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/1ca6da28cc8b22fb742c790c96543ab9?s=96&r=g","caption":"Instamojo"},"description":"India's simplest D2C tech platform. Host your online store, create landing pages, or share payment links. Sign up for free.","sameAs":["http:\/\/instamojo.com","facebook.com\/instamojo","https:\/\/twitter.com\/instamojo"],"url":"https:\/\/www.instamojo.com\/blog\/author\/instamojo\/"}]}},"_links":{"self":[{"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/posts\/27"}],"collection":[{"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/comments?post=27"}],"version-history":[{"count":6,"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/posts\/27\/revisions"}],"predecessor-version":[{"id":17321,"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/posts\/27\/revisions\/17321"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/media\/4680"}],"wp:attachment":[{"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/media?parent=27"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/categories?post=27"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.instamojo.com\/blog\/wp-json\/wp\/v2\/tags?post=27"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}