paytm developer docs logoDeveloperDocumentation
search

Callback and Webhook URL

Callback URL and webhook are used to get the status of the transaction for a payment source.

Callback URL

Paytm sends the response of the transaction on the callback url sent by the merchant. The response of the transaction in the callback URL can be intermediate or final status. The URL in the format "https://<domain_name_callback_url>" can be sent in request parameter callbackUrl of the relevant API as per the use case.

 

In case of android/iOS SDK integration, you have the option to send the following callback URL. On completion of the transaction, Paytm payment gateway will send the response on this URL.

  • Staging Environment: https://securegw-stage.paytm.in/theia/paytmCallback?ORDER_ID=<order_id>
  • Production Environment: https://securegw.paytm.in/theia/paytmCallback?ORDER_ID=<order_id>

Webhook URL

Webhooks are the user specified HTTP callbacks that get triggered by some event reactions and used to connect two applications. It’s a way to send response payload from Paytm server to a unique URL configured at Paytm’s end to notify the final status of transaction, refund, etc. Unlike an API, where you need to poll the data frequently to get the real time information, it lets you receive the automated, instant, real-time data from Paytm server to your server on occurence of a given event.

 

To consume a webhook, initially you must configure a URL at Paytm’s end that is accessible from the public web, the URL should be capable of handling the updated event/response sent by Paytm. It provides the mechanism to Paytm Payment gateway to notify your customer on the URL provided by them about an occurrence outside the flow.

Note: Currently the webhook URLs only allow port number 443

You can get the response on Callback URL and on webhook URL as events notifications.

In addition, you can configure separate webhooks URLs for the following events notifications.

Webhook Configuration