Penny drop + PennyLess Notifications

Reading time — 2 minutes

#Notifications

Below is the summary of the notifications which need to be processed on your server by exposing an endpoint for Setu to send an HTTP POST request. These notifications are sent by Setu when the Penny drop + PennyLess request is completed

Please send back an HTTP 2xx status code if the request sent was processed correctly to avoid receiving multiple notifications for the same event. Response body is ignored.

This will help you understand the notification flow before you start to implement it on your server.

#Notification Samples

Here’s a sample notification of a successful Penny drop + PennyLess request, with the corresponding request id as well as the details of the account holder.

{
  "data": {
      "id": "50c4b0a4-7de2-4eb3-9d78-153fb4d9991d",
      "fulfillmentType": "PENNYLESS", // OR "PENNYDROP"
      "status": "SUCCESS",
      "traceId": "..."
      "data": {
        "bankAccountNumber": "20161854381",
        "bankAccountName": "MR PAVANKUMAR NAGARAJ KAMAT",
        "bankAccountIfsc": "SBIN0015421",
        "entityType": "MERCHANT", // or "INDIVIDUAL". Note: this key will be present in case of fulfillmentType=PENNYLESS
        "ifscCrossCheck": true,
        "ifscDetails": { // if ifscCrossCheck=true
          "name": "State Bank of India",
          "branch": "SHIVAJI CHOWK, SIRSI",
          "center": "UTTAR KAKINADA",
          "district": "UTTAR KAKINADA",
          "state": "KARNATAKA",
          "address": "MAHESH PLAZA, NATARAJ ROAD, SIRSI. PIN581401 UTTARA KANNADA DIST KARNATAKA",
          "contact": "",
          "imps": "true",
          "rtgs": "true",
          "city": "SIRSI",
          "iso3166": "IN-KA",
          "neft": "true",
          "micr": "581002402",
          "upi": "true",
          "swift": ""
        }
      },
      "merchantDetails": { // if entityType is "MERCHANT" AND fulfillmentType is "PENNYLESS"
        "mccCode": "1520",
        "identifier": {
          "merchantType": "SMALL",
          "merchantGenre": "OFFLINE",
          "onBoardingType": "BANK"
        },
        "name": {
          "brand": "praimports",
          "legal": "Indian",
          "franchise": "rajababuimpor"
        },
        "ownership": {
          "type": "PRIVATE"
        }
    }
  },
  "event": "SETU_BAV_NOTIFICATION",
  "timeStamp": "2023-08-22T20:44:40.203527+05:30"
}

Here is a sample notification of a failed Penny drop + PennyLess request, with the corresponding request id as well as the reason for failure.

  {
  "data": {
     "id": "50c4b0a4-7de2-4eb3-9d78-153fb4d9991d",
      "error": {
          "code": "<SETU_BAV_CODE>",
          "detail": "<SETU_BAV_CODE_DESCRIPTION>",
          "traceId": ""
      }
  },
  "event": "SETU_BAV_NOTIFICATION",
  "timeStamp": "2023-08-22T20:44:40.203527+05:30"
}
  

Was this page helpful?

—

–

#Notifications

#Notification Samples