To reiterate, an agent is an entity on BBPS, that enables its customers to pay any business that is listed on BBPS. For this, you need to use your details registered on BBPS, with an agent ID, to fetch bills for customers, from BBPS-listed businesses.
Share business details
Reach out to firstname.lastname@example.org to get a list of business details you need to provide to set up your BBPS agent ID(s).
Share callback URL
It is recommended that you set up a callback URL to receive notifications for various types of events, while using—
APIs to fetch bill for a customer
APIs to validate customer identifier with a biller
APIs to for completing a bill payment
APIs to raise disputes against a payment
APIs to receive an automatic bill due notification
When this is enabled by you, any successful fetch, validate, payment, dispute or autofetch event gets posted to your callback URL.
You may specify only one callback URL. This should be a valid URI string that starts with either https:// or http:// scheme.. For e.g., https://my-billpay-callback.com.
Setu will append the following default paths to this callback URL, to alert your on specific events—
fetch a bill
validate bill details
payment of bill
dispute against bill
autofetch of a bill
You may also optionally choose to specify custom paths or URLs for fetch/validate/payment/dispute events too. The URL may be relative (a path, without a host) or absolute (starting with a scheme).
In case you specify a path, it will get appended to the callbackURL value. If you specify a URL, it will simply override the callback URL value for that particular event.
There are also other events that are not related to the core BillPay APIs, but are updates about the businesses on BBPS.
This would include alerts on businesses that may be delisted from BBPS, or if a business updates the type of identifier they accept to fetch a customer’s bill. If you maintain a database of BBPS businesses, you may want to use such events to stay up-to-date. Find the full list of events here.
Once you have received your API keys and agent ID for testing, you can integration with our APIs and start testing out different scenarios for fetching/paying bills or for raising disputes and managing its resolution.