TABLE OF CONTENTS
- What is a Bill Object?
- What is a Settlement Object?
- What is the time format to be used in APIs?
- I have an existing API with similar functionality, can it be used?
- Is there any other way to upload bills other than using the APIs for BBPS?
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.