Webhook URL

What is a webhook URL?

Webhooks are user defined HTTP callbacks. Instamojo uses them to inform the merchant about every successful or a failed transactions using a server side call (POST request) or webhook. Webhook request is an asynchronous request which means you don’t have to trigger it. After a successful or a failed transaction Instamojo will POST the transaction details to the webhook URL you may have configured.

Notes:

1. The webhook request is request with content-type application/www-form-urlencoded. Don't try to handle it like a JSON request.

2. The POST view you're using to handle this webhook request must not expect a CSRF token, otherwise it is not going to work(CSRF is enabled by default in most of the frameworks).

We have mentioned the parameters below which are sent using a webhook: 

Key

Description

amount

Amount related to the payment

buyer

Buyer's email

buyer_name

Buyer's name

buyer_phone

Buyer's phone number

currency

Currency related to the payment

fees

Fees charged by Instamojo

longurl

URL related to the payment request

mac

Message Authentication code of this webhook request

payment_id

ID of the payment

payment_request_id

ID of the payment request

purpose

Purpose of the Payment request

shorturl

Short URL of the payment request

status

Status of the Payment. This can be either "Credit" or "Failed".

This list of keys will get updated over time. So when you are integrating, we recommend you to account for new keys that will be added to this.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request