--- page_title: Webhooks product: HyperCredit platform: Web page_source: https://juspay.io/in/docs/hyper-credit/web/status-tracking/webhooks llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/hyper-credit/llms.txt --- # **Webhooks** After the completion of every payment/refund call, Juspay will provide direct notification to your server regarding events, like: Order Created, Txn Created, Loan Application Initiated, Offer Selected, KYC Completed, Loan Active, Order Successful etc. These direct notifications are called Webhooks. ## **Why would we say that?** It's possible that the status of an order was updated, but you may not have polled our HyperCredit Order Status API. This could result in a delay in updating your customers about their order status. To address this issue and ensure timely updates to your customers, we highly recommend utilizing Webhooks in addition to the Status API. HyperCredit offers two types of webhooks: ## **Order Webhooks:** Please refer [here](https://juspay.io/in/docs/hyper-checkout/web/base-sdk-integration/webhooks) for the webhook payload to track the order status. ## **Loan Webhooks:** #### **Configuration:** Loan Webhooks cannot be enabled directly, but are configured by the HyperCredit Merchant Success Team on demand. To enable webhooks, please share the following details: 1. Path - This is the path of the server where you wish to receive the webhooks 2. Domain - This is the domain of the server where you wish to receive the webhook Upon receiving these details, the Juspay HyperCredit team will configure the webhook URL on the backend, enabling its use. **Events:** The merchant will receive webhook notifications for the below mentioned events | Event | Description | |---|---| | LOAN_PROCESS_INITIATED | User has started filling in details for Loan. | | E ELIGIBILITY_CRITERIA_QUALIFIED | Applicant passed Eligibility Criteria of 1 or more Lenders | | ELIGIBILITY_CRITERIA_REJECTED | Applicant failed Eligibility Criteria of all the lenders | | LENDER_SELECTED | Applicant has initiated Loan with Lender/s | | LOAN_OFFERED | One or more Loan Schemes offered by Lender | | IN_PROGRESS_BY_LENDER | Applicant has been redirected to Lender’s Website | | OFFER_SELECTED | Applicant has opted for one Loan Offer | | USER_ACTION_REQUIRED | Applicant needs to perform additional Steps | | KYC_COMPLETED | Applicant has completed KYC | | KYC_REJECTED | Applicant KYC didn’t meet lender’s requirement | | REPAYMENT_COMPLETED | Applicant completed Repayment Setup | | AGREEMENT_SIGNED | Applicant completed Agreement Signing | | DOWNPAYMENT_COMPLETED | Applicant completed Downpayment | | LOAN_GRANTED | Loan has been granted by the Lender | | LOAN_ACTIVE | Loan has been Successful | | LENDER_LOAN_REJECTED | Lender has Rejected user’s Loan Application | | LOAN_APPLICATION_FAILED | Loan Application failed due to some error | | UTR_RECEIVED | Loan is Disbursed and Settlement details are received | ### **Handling Webhook:** When consuming webhooks, it's essential to provide a 200 Status Response. Juspay considers a webhook as "not notified" if it receives a non-200 response and will re-send the webhook thrice until a 200 response is received. 💡**Tips** Implement both Order and Loan webhooks together with the Loan Order Status API for the most reliable status tracking. **WEBHOOK SAMPLE PAYLOAD:** #### webhook Sample Payload Code Snippet: ```webhook sample payload { "id": "LSPc1da62f0371c4cf5937c6df655d7d5f0", "date_created": "2025-10-15 06:26:53.879043056 UTC", "content": { "order": { "udf4": "1135", "user_message": null, "payment_methods_eligibility": [ { "error_message": null, "payment_method": "EARLY_SALARY_LSP", "is_eligible": true }, { "error_message": null, "payment_method": "AVANSE_LSP", "is_eligible": true }, { "error_message": null, "payment_method": "GRAYQUEST_LSP", "is_eligible": true }, { "error_message": null, "payment_method": "TECHFINO_LSP", "is_eligible": true } ], "payout_links": null, "udf8": "", "error_message": null, "udf3": "45", "udf6": "0", "status": "CHARGED", "id": "LSP29209650e9e149a4bb3bb43737b2dcc9", "return_url": null, "expiry_at": null, "error_code": null, "currency": "INR", "error": null, "date_created": "2025-10-13T06:04:23.754737Z", "udf2": "BBA", "payment_links": { "mobile": null, "web": null, "iframe": null }, "customer_email": "XXXXXXXXXXXX2@gmail.com", "customer_phone": "XXXXX60705", "order_status": "CHARGED", "udf5": "", "status_id": 3, "merchant_id": "testmx", "udf9": "", "amount": 155650, "gateway_reference_id": "testmx Live", "txn_list": [ { "refunds": null, "txn_detail": { "gateway": "LSP", "error_message": null, "status": "CHARGED", "lender_account_details": { "lender_name": null, "lender_bank_account_number": "XXXXXHARED", "lender_bank_IFSC": "XXXXXHARED", "lender_bank_branch": null, "lender_bank_name": "XXXXXBank" }, "txn_amount": "155650.00", "net_amount": 9000, "surcharge_amount": null, "tax_amount": null, "txn_uuid": "moz6PEjWx9JGCRJThuw", "gateway_id": 1, "error_code": null, "currency": "INR", "created": "2025-10-13 06:04:59.922789 UTC", "utr": "UTIBN62025101487564", "settlement": { "processing_fees_gst_amount": null, "subvention_gst_amount": null, "processing_fees_amount": null, "subvention_amount": 26460.5, "settlement_date": "2025-10-14 00:00:00 UTC", "utr": "UTIBN62025875654", "tenure": 24, "down_payment_amount": null, "settlement_amount": 129189 }, "order_id": "1901887", "txn_id": "testmx-1901887-1" }, "emi_bank": null, "bank_error_code": null, "status": "CHARGED", "bank_error_message": null, "txn_intent_id": "LSPyD0ZBBuBjhgf765yA4", "txn_uuid": "moz6PEjWx9JGCRJThuw", "gateway_id": 1, "sub_status": "Loan Active", "txn_type": "LOANPAYMENT", "resp_message": null, "payment_links": null, "emi_tenure": 24, "resp_code": null, "gateway_reference_id": "testmx Live", "refunded": null, "payment_method": "TECHFINO_LSP", "txn_intent_amount": "155650.0", "payment_gateway_response": { "epg_txn_id": "LA-501-HIG-03h679", "resp_message": null, "created": "2025-10-13 06:04:59.922789 UTC", "rrn": "UTIBN620251014757554", "resp_code": null, "txn_id": "testmx-1901887-1" }, "txn_id": "testmx-1901887-1", "payment_method_type": "TECHFINO_LSP", "amount_refunded": null, "offer_detail": { "interest_amount": 0.08000000001629815, "processing_fees": null, "interest_rate": 0, "advance_emi": null, "emi_tenure": 24, "emi_amount": 6485.42, "downpayment_amount": null, "interest_type": "REDUCING" } } ], "order_id": "1901887", "udf7": "2", "udf10": "", "customer_id": "10732425", "udf1": "10732425" } }, "event_name": "XXXXXXCEIVED" } ``` } --- ## See Also - [Status APIs](https://juspay.io/in/docs/hyper-credit/web/status-tracking/status-apis) - [Fetch State](https://juspay.io/in/docs/hyper-credit/web/exclusive-supported-features/fetch-state)