Fetch Events Webhook API

This API allows you to retrieve the complete list of webhook events supported by PhonePe across all payment and subscription flows. By invoking this API, you can fetch the event types that may be triggered during various stages of the transaction lifecycle, such as payment completion, failure, refund updates, disputes, or subscription actions.

Environment

Environment	Http Method	API
`Sandbox`	GET	https://api-preprod.phonepe.com/apis/pg-sandbox/configs/v1/webhooks/events
`Production`	GET	https://api.phonepe.com/apis/pg/configs/v1/webhooks/events

Request

Request Headers

Header Name	Header Value	Description
`Content-Type`	application/json
`Authorization`	O-Bearer <access_token>	Pass `access_token` received in Authorization call

Response

Response Headers

Header Name	Header Value
`Content-Type`	application/json

Sample Response for case 1: Success Response

{
    "events": [
        "checkout.order.completed",
        "checkout.order.failed",
        "pg.order.completed",
        "pg.order.failed",
        "pg.refund.completed"
    ]
}

Sample Response for case 2: Failed with Invalid Auth Token

{
    "code": "AUTHORIZATION_FAILED",
    "message": "Authorization failed [message = Please check the authorization token and try again]"
}

Sample Response for case 3: Internal Server Error

{
    "code": "INTERNAL_SERVER_ERROR",
    "message": "There is an error trying to process your transaction at the moment. Please try again in a while."
}