#Bundled Bank Account Verification
#What is Bundled BAV?
Setu's Bundled Bank Account Verification flow allows you to verify your customers' bank accounts with one orchestrated flow that supports multiple BAV methods and returns a unified response.
You can simply create a request with the customer's phone number, which generates a verification URL to start the BAV journey.
#Which BAV methods are supported?
- Penny Drop
- Reverse Penny Drop
- Mobile to Bank Account
- UPI ID to Bank Account
#How does it work?
- Create a verification request — Call the API with your customer's phone number to generate a verification URL
- Open URL in webview — Display the URL in a webview within your app
- Customer completes verification — The customer verifies their bank account using any of your enabled methods
- Receive webhook notification — Once verification is complete, bank account details are sent to your configured webhook endpoint
- Close webview — Set up an event listener to detect the redirect and close the webview
#Step 1 — Get API credentials
Contact Setu at onboarding@setu.co to get your API credentials and configure your product instance.
#Step 2 — Configure product settings
Work with Setu to configure the following for your product instance:
- List of supported BAV methods
- Webhook notification URL for receiving verification results
- Redirect URL for post-verification navigation
- Primary theme color (e.g., primary button background color)
- Primary foreground color (e.g., primary button text color)
- Logo URL (optional)
#Step 3 — Test on sandbox
Use the sandbox environment to test the Bundled BAV flow:
Sandbox base URL — https://dg-sandbox.setu.co
API integration
Refer to the API integration guide for detailed implementation steps.
#Next steps
Learn how to integrate the Bundled BAV API into your application.
Complete API reference with request and response schemas.
Was this page helpful?
