feature(bill payments): plan mdm integration guide #278
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Checklist to merge a PR 🚀To merge this pull request, please take time to complete the checklist. What action did you perform?Review the corresponding checklist items for the action you performed and mark them done. Edit an existing content (MDX) pageChecklist
Edit an existing API reference pageChecklist
Add a new content (MDX) pageChecklist
Add a new API reference pageChecklist
|
tanmay-dixit
requested changes
Jun 24, 2025
| ### Key Use Cases | ||
| - **Mobile Prepaid Recharges** - Choose data/talk time plans | ||
| - **DTH Services** - Select channel packages and validity periods | ||
| - **Mutual Fund Houses** - Investment plan subscriptions |
There was a problem hiding this comment.
We don't have mutual funds as a category right now.
There was a problem hiding this comment.
Lets just keep mobile prepaid recharges and DTH right now
Comment on lines
+20
to
+24
| ### Benefits | ||
| - **Seamless Integration** - Replicate existing user flows within BBPS | ||
| - **Flexible Plan Management** - Support both static and dynamic plan offerings | ||
| - **Real-time Updates** - Webhook notifications for plan changes | ||
| - **Standardized API** - Consistent integration patterns across biller types |
There was a problem hiding this comment.
Lets compress these 4 points into smaller points that are more intuitive and relevant for API clients
| | Step | Actor | Action | API Endpoint | | ||
| |------|--------|--------|--------------| | ||
| | 1 | Customer | Initiates service subscription | - | | ||
| | 2 | App/Platform | Retrieve available plans | `GET /api/v2/bbps/billers/plans` | |
There was a problem hiding this comment.
Can change App/Platform to Your App
| | 5 | App/Platform | Validate customer details with plan ID | `POST /api/v2/bbps/bills/fetch/request` | | ||
| | 6 | Setu API | Forward validation to biller | - | | ||
| | 7 | Biller | Validate account and plan compatibility | - | | ||
| | 8 | App/Platform | Check validation status | `POST /api/v2/bbps/bills/fetch/response` | |
There was a problem hiding this comment.
Same change for Your App. Also, alternate way of getting status is via webhook
| **Start Here:** What type of biller are you integrating? | ||
|
|
||
| ``` | ||
| Is planRequirement = "MANDATORY"? |
There was a problem hiding this comment.
planRequirement is a field obtained from the list billers api
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.