Webhooks

This product helps Merchants/Payment Aggregators/Market Places who are based outside India to collect payment payment from customers based out of India

Webhooks are server callbacks to your server from Cashfree Payments. Webhooks are event-based and are sent when specific events related to the transaction happen.

Click here to know how to configure webhooks.

Payment Verification

Payment Verification details webhook version (2025-01-01)

The payment verification details update webhook notifies you about the payment details verification, and it give you comprehensive information about verification details update.

A notification is sent to your backend from cashfree when there is any new update for payment verification. These notification are useful in cases when the internet connection is unstable or slow while the payment is getting processed. This will allow you to reconcile all the payment verification update at your end. Notifications will be sent to notifyUrl which is a part of the request parameter specified while creating an order request.

Sample Payload

Json

{
	"data": {
	    "order_id": "e145c994-5899-4466-804d-b90c625b2c1b",
		"cf_payment_id": 5114910634577,
		"payment_status": "SUCCESS",
		"payment_verification_status": "ACTION_REQUIRED",
		"payment_verification_expiry": "2024-07-12T15:19:42+05:30",
		"remarks": null,
		"required_details": [
            {
                "doc_name": "goods_description",
                "doc_type": "VALUE",
                "doc_status": "ACTION_REQUIRED",
                "remarks": null
            },
            {
                "doc_name": "invoice_number",
                "doc_type": "VALUE",
                "doc_status": "IN_REVIEW",
                "remarks": null
            },
            {
                "doc_name": "importer_name",
                "doc_type": "VALUE",
                "doc_status": "IN_REVIEW",
                "remarks": null
            },
            {
                "doc_name": "importer_address",
                "doc_type": "VALUE",
                "doc_status": "IN_REVIEW",
                "remarks": null
            },
            {
                "doc_name": "country_of_origin",
                "doc_type": "VALUE",
                "doc_status": "IN_REVIEW",
                "remarks": null
            },
            {
                "doc_name": "invoice_file",
                "doc_type": "DOCUMENT",
                "doc_status": "IN_REVIEW",
                "remarks": null
            },
            {
                "doc_name": "ecommerce_order_serial_number", //Required for Physical Goods and Digital Goods
                "doc_type": "VALUE",
                "doc_status": "ACTION_REQUIRED",
                "remarks": null
            },
            {
                "doc_name": "hs_code", //Required for Physical Goods and Digital Goods
                "doc_type": "VALUE",
                "doc_status": "IN_REVIEW",
                "remarks": null
            },
            {
                "doc_name": "shipment_date", //Required for Physical Goods
                "doc_type": "VALUE",
                "doc_status": "ACTION_REQUIRED",
                "remarks": null
            },
            {
                "doc_name": "port_of_loading",//Required for Physical Goods
                "doc_type": "VALUE",
                "doc_status": "IN_REVIEW",
                "remarks": null
            },
                {
                "doc_name": "awb_number",//Required for Physical Goods
                "doc_type": "VALUE",
                "doc_status": "IN_REVIEW",
                "remarks": null
            }
		]
	},
	"event_time": "2024-07-12T13:39:42+05:30",
	"type": "PAYMENT_VERIFICATION_UPDATE"
}