Webhooks V2

type PayoutWebhookEvent struct {
Type   string
Raw    string
Object interface{}
}

func PayoutVerifyWebhookSignature(signature string, rawBody string, timestamp string) (*PayoutWebhookEvent, error) {
signatureString := timestamp + rawBody
hmacInstance := hmac.New(sha256.New, []byte(*XClientSecret))
hmacInstance.Write([]byte(signatureString))
bytesData := hmacInstance.Sum(nil)
generatedSignature := base64.StdEncoding.EncodeToString(bytesData)
if generatedSignature == signature {
var object interface{}
err := json.Unmarshal([]byte(rawBody), &object)
if err != nil {
return nil, errors.New("something went wrong when unmarshalling raw body")
}
if objectAsMapInterface, ok := object.(map[string]interface{}); ok {
if webhookType, ok := objectAsMapInterface["type"].(string); ok {
return &PayoutWebhookEvent{Type: webhookType, Raw: rawBody, Object: object}, nil
}
}
return &PayoutWebhookEvent{Type: "", Raw: rawBody, Object: object}, nil
}
return nil, errors.New("generated signature and received signature did not match")
}

import crypto from 'crypto';

class PayoutWebhookEvent {

    constructor(type, rawBody, object) {
        this.type = type;
        this.raw = rawBody;
        this.object = object;
    }
}

class Cashfree {
    static XClientSecret;
    static XApiVersion = "2024-01-01";

    /**
     * Use this API to verify your webhook signature once you receive from Cashfree's server.
     * @summary Verify Webhook Signatures
     * @param {string} signature that is present in the header of the webhook ("x-webhook-signature")
     * @param {string} rawBody is the entire body sent to the server in string format
     * @param {string} timestamp that is present in the header of the webhook ("x-webhook-timestamp")
     * @throws {Error}
     */
    static PayoutVerifyWebhookSignature(signature, rawBody, timestamp) {
        const body = timestamp + rawBody;
        const secretKey = Cashfree.XClientSecret;
        let generatedSignature = crypto.createHmac('sha256', secretKey).update(body).digest("base64");
        if (generatedSignature === signature) {
            let jsonObject = JSON.parse(rawBody);
            return new PayoutWebhookEvent(jsonObject.type, rawBody, jsonObject);
        }
        throw new Error("Generated signature and received signature did not match.");
    }
}

{
data: {
  "transfer_id": "JUNOB2018",
  "cf_transfer_id": "123456",
  "status": "SUCCESS",
  "status_code": "COMPLETED",
  "status_description": "The transfer has been initiated via the partner bank successfully. The request is waiting to be processed at the beneficiary bank to do the credit to the end beneficiary.",
  "beneficiary_details": {
    "beneficiary_id": "JOHN18011",
    "beneficiary_instrument_details": {
      "bank_account_number": "7766671501729",
      "bank_ifsc": "SBIN0000003"
    }
  },
  "transfer_amount": 1,
  "transfer_service_charge": 1,
  "transfer_service_tax": 0.18,
  "transfer_mode": "BANK",
  "transfer_utr": "TESTR92023012200543116",
  "fundsource_id": "CASHFREE_1",
  "added_on": "2021-11-24T13:39:25Z",
  "updated_on": "2021-11-24T13:40:27Z"
},
event_time: '2024-07-25T17:43:37',
type: 'TRANSFER_ACKNOWLEDGED'
}

{
data: {
  "transfer_id": "JUNOB2018",
  "cf_transfer_id": "123456",
  "status": "SUCCESS",
  "status_code": "SENT_TO_BENEFICIARY",
  "status_description": "The transfer has been initiated via the partner bank successfully, hence your account is debited and the request is successfuly processed by the beneficiary bank and has been credited to the end beneficiary.",
  "beneficiary_details": {
    "beneficiary_id": "JOHN18011",
    "beneficiary_instrument_details": {
      "bank_account_number": "7766671501729",
      "bank_ifsc": "SBIN0000003"
    }
  },
  "transfer_amount": 1,
  "transfer_service_charge": 1,
  "transfer_service_tax": 0.18,
  "transfer_mode": "BANK",
  "transfer_utr": "TESTR92023012200543116",
  "fundsource_id": "CASHFREE_1",
  "added_on": "2021-11-24T13:39:25Z",
  "updated_on": "2021-11-24T13:40:27Z"
},
event_time: '2024-07-25T17:43:37',
type: 'TRANSFER_SUCCESS'
}

{
data: {
  "transfer_id": "JUNOB2018",
  "cf_transfer_id": "123456",
  "status": "SUCCESS",
  "status_code": "COMPLETED",
  "status_description": "The transfer has failed because the beneficiary account doesnot support IMPS transfers. This rejection is done by the partner bank for the specific beneficiary account. You can try NEFT or other channels to do the disbursals.",
  "beneficiary_details": {
    "beneficiary_id": "JOHN18011",
    "beneficiary_instrument_details": {
      "bank_account_number": "7766671501729",
      "bank_ifsc": "SBIN0000003"
    }
  },
  "transfer_amount": 1,
  "transfer_service_charge": 1,
  "transfer_service_tax": 0.18,
  "transfer_mode": "BANK",
  "transfer_utr": "TESTR92023012200543116",
  "fundsource_id": "CASHFREE_1",
  "added_on": "2021-11-24T13:39:25Z",
  "updated_on": "2021-11-24T13:40:27Z"
},
event_time: '2024-07-25T17:43:37',
type: 'TRANSFER_FAILED'
}

{
data: {
  "transfer_id": "JUNOB2018",
  "cf_transfer_id": "123456",
  "status": "REVERSED",
  "status_code": "INVALID_ACCOUNT_FAIL",
  "status_description": "The transfer has been reversed by the beneficiary bank because the Account Number of the beneficiary is invalid. After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).",
  "beneficiary_details": {
    "beneficiary_id": "JOHN18011",
    "beneficiary_instrument_details": {
      "bank_account_number": "7766671501729",
      "bank_ifsc": "SBIN0000003"
    }
  },
  "transfer_amount": 1,
  "transfer_mode": "BANK",
  "fundsource_id": "CASHFREE_1",
  "added_on": "2021-11-24T13:39:25Z",
  "updated_on": "2021-11-24T13:40:27Z"
},
event_time: '2024-07-25T17:43:37',
type: 'TRANSFER_REVERSED'
}

{
data: {
  "transfer_id": "JUNOB2018",
  "cf_transfer_id": "123456",
  "status": "REJECTED",
  "status_code": "INVALID_MODE_FOR_PYID",
  "status_description": "The transfer has been rejected because the fundsource does not support this mode of transfer. You should get this mode activated on the fundsource by contacting Cashfree, and then initiate a new transfer request.",
  "beneficiary_details": {
    "beneficiary_id": "JOHN18011"
  },
  "transfer_amount": 1,
  "transfer_mode": "BANK",
  "fundsource_id": "CASHFREE_1",
  "added_on": "2021-11-24T13:39:25Z",
  "updated_on": "2021-11-24T13:40:27Z"
},
event_time: '2024-07-25T17:43:37',
type: 'TRANSFER_REJECTED'
}

{
data: {
  "batch_transfer_id": "test_batch_transfer_id",
  "cf_batch_transfer_id": "123456",
  "status": "REJECTED"
},
event_time: '2024-07-25T17:43:37',
type: 'BULK_TRANSFER_REJECTED'
}