TABLE OF CONTENTS


What is a Bill Object?

  • Bill Object is Setu’s standard way of getting the details from a biller’s system. This contains info about the user, about the bill value, and different line items and breakups (such as taxes, fee, etc) within a bill. For more details, refer to documentation on creating bill objects.


What is a Settlement Object?

  • Settlement Object within a bill defines the money routing rules for settlement after the transaction is complete. It could be used to define which account to settle the money into as well as how much should which account get.
  • If you have more than one bank account registered with Setu, it is mandatory to use the Settlement Object. Refer to detailed documentation on the Settlement object


What is the time format to be used in APIs?

  • All timestamp related JSON parameters in Setu APIs use UTC time in ISO-8601 format with milliseconds precision. In general, this can be defined by the following datetime format - YYYY-MM-DDTHH:mm:ss.mmmZ - where ‘T’ and ‘Z’ are constants and other symbols have their usual meanings.
  • All JWT tokens to be used with Setu APIs also contain a timestamp field called ‘iat’. This is an Epoch timestamp with seconds precision.