SetuBot
—
–
/

to search

Introducing Setu API playground Check it out ↗

Reading time — 1 minutes

Edit this page ↗

#Notifications

Outgoing event alerts sent by Setu to partners.

Currently, there is one event—BILL_SETTLEMENT_STATUS, which triggers a notification as explained below.

#Bill settlement status

Bill settled

A SETTLEMENT_SUCCESSFUL notification is sent to the biller after successful settlement from Setu to the biller. This depends on the settlement frequency agreed upon between Setu and the biller.

// Sample JSON structure
{
    "partnerDetails": {
        "appID"             : "string",
        "productInstanceID" : "string"
    },
    "events": [
        {
            "id"        : "f3b41c8f-72fc-485d-b39a-cf497787a039",
            "type"      : "BILL_SETTLEMENT_STATUS",
            "timeStamp" : 1594293083984,
            "data"      : {
                "amountSettled"     : {
                    "currencyCode" : "INR",
                    "value"        : 108400 // in paise
                },
                "platformBillIds"   : ["platformBillId1", "platformBillId2"], // list of strings  
                "status"            : "SETTLEMENT_SUCCESSFUL",
                "transactionId"     : "1074362738220"
            }
        }
    ]
}

As next steps, you can either start your internal reconciliation process or consume our Report APIs ↗ to get detailed settlement reports.

Was this page helpful?