Cashfree Payments will notify you whenever we create an incident at our end. An incident implies that the issuing bank is facing high failure rates or has scheduled a maintenance activity during that time. The former could be due to many reasons and until the failure rates go down, we would recommend customers to use alternative payment instruments.
There are two channels through which we notify. You can subscribe to either of the channels by adding your email address and webhook endpoint in the merchant dashboard.
Email - Cashfree Payments will send an email alert when an issuer is facing downtime or a scheduled incident.
Webhooks - Cashfree Payments will invoke a server to server call whenever an incident is created. You can use this webhook and update your payment page accordingly.
The signature must be used to verify if the request has not been tampered with. To verify the signature at your end, you will need your Cashfree Payment Gateway secret key along with the payload.
//The payload here refers to the raw request sent by Cashfree to your endpoint. No modifications need to be done to this payload.payload := {"data":{"bank_name":"Test Bank","card_type":"Visa","health":"DEGRADED","incident_end_time":"2021-04-07T00:20:30","incident_id":"INCIDENT_HIGH_Test Bank_954b95zz-f11a-test-abcd-0eb0e8608847","incident_impact":"High","incident_start_time":"2021-04-06T00:20","incident_type":"Scheduled","is_resolved":false,"issuers":[],"message":"We are facing high failure issues in Payment gateway at the moment and will keep you updated about the issue.","payment_gateway":null,"payment_mode":"DEBIT_CARD","scope":"PaymentMode"},"type":"HEALTH_ALERT","version":1}# timestamp is present in the header x-cashfree-timestamptimestamp := 1617695238078signedPayload := $timestamp.$payloadexpectedSignature := Base64Encode(HMACSHA256($signedPayload, $merchantSecretKey))