With the biller’s MDM details in hand, use this API to initiate a bill fetch or validation for the customer. Pass the customer input parameters specified in the biller’s MDM response, such as a consumer number or mobile number, along with the agent device context. The API automatically determines the payment flow (FETCH_AND_PAY or VALIDATE_AND_PAY) based on the biller’s configuration.
This API is only applicable for billers whose fetch_requirement or support_bill_validation is MANDATORY or OPTIONAL. For billers where both are NOT_SUPPORTED (DIRECT_PAY flow), skip this step and proceed directly to the Bill Payment Request API.
Flow determination logic
The flow is evaluated in the following priority order based on the biller’s MDM configuration:
Priority
fetch_requirement
support_bill_validation
Flow
1
MANDATORY
Any
FETCH_AND_PAY
2
NOT_SUPPORTED
MANDATORY or OPTIONAL
VALIDATE_AND_PAY
3
NOT_SUPPORTED
NOT_SUPPORTED
DIRECT_PAY
4
OPTIONAL
MANDATORY
VALIDATE_AND_PAY
5
OPTIONAL
Any other
FETCH_AND_PAY
For DIRECT_PAY, this API is not applicable. Calling it returns a validation error. Proceed directly to the Bill Payment Request API.
With synchronous responses enabled, handle both HTTP 200 and HTTP 202, and set your HTTP client timeout to at least 30 seconds. For details, see Synchronous responses.
Once you receive a successful bill fetch, proceed to the Bill Payment Request API to complete the payment. When polling the Bill Fetch Response API for the result, check the biller’s biller_response_type field from the Fetch Biller MDM Details response. If it is LIST (the biller can return multiple outstanding bills in a single fetch, such as traffic challans), use x-api-version: 2026-01-01 on the response API to receive all bills in the biller_responses array. For all other billers, use the default x-api-version: 2025-01-01, which returns a single bill in biller_response.
Your unique client secret issued by Cashfree. Keep this confidential and never expose it in client-side code. You can find this in your Merchant Dashboard.
Final result returned in the same call. Returned only when synchronous responses are enabled for your account and the result is ready within the synchronous wait period.
The status of the API call. Returns OK when the request is successfully processed and the final result is available in the same call. This field indicates the API call succeeded. The outcome of the bill fetch operation is available in the data object.
Contains the final result of the bill fetch request.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cashfree Developer Documentation","colors":{"primary":"#6930ca","light":"#cfb8f5","dark":"#130851"},"logo":{"light":"https://mintcdn.com/cashfreepayments-d00050e9/6mQw7is1us8FhXrb/static/logo/light.svg?fit=max\u0026auto=format\u0026n=6mQw7is1us8FhXrb\u0026q=85\u0026s=8a2837083063d8a01e0be6b454a1baf1","dark":"https://mintcdn.com/cashfreepayments-d00050e9/6mQw7is1us8FhXrb/static/logo/dark.svg?fit=max\u0026auto=format\u0026n=6mQw7is1us8FhXrb\u0026q=85\u0026s=5c7de40784c6f6f9eebdad085ec5a7ef"},"favicon":"https://mintcdn.com/cashfreepayments-d00050e9/NpjCgm3mwC7v6gp-/static/favicon.png?fit=max\u0026auto=format\u0026n=NpjCgm3mwC7v6gp-\u0026q=85\u0026s=ba85dcd024bd70845e38c3f3957514c6","appearance":{"default":"light","strict":false},"background":{"color":{"light":"#fbfbfb","dark":"#000000"}},"navbar":{"links":[{"href":"https://www.cashfree.com/support/","label":"Contact Us"}],"primary":{"type":"button","label":"Get Started","href":"https://merchant.cashfree.com/merchants/signup?source-action=docs%20page\u0026action=Sign%20Up\u0026button-id=StartNow_Navbar"}},"footer":{"socials":{"github":"https://github.com/cashfree","youtube":"https://www.youtube.com/channel/UCxO0W7xVngh7TfkChPa_nwg","website":"https://www.cashfree.com/blog/category/engineering","discord":"https://discord.com/invite/w97HT9RKCF"}},"search":{"prompt":"Search or ask..."},"seo":{"metatags":{"og:title":"Cashfree Developer Documentation","og:description":"Welcome to the Cashfree developer documentation. You will find help about Cashfree products and APIs that will help you start using our products quickly.","og:site_name":"Cashfree Developer Documentation","twitter:site":"@gocashfree","google-site-verification":"T69Ao_T0Ps8pkRbluKzW179qvd_aCsWISCApeSsIhRU"},"indexing":"all"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"codeblocks":"dark","latex":true},"integrations":{"ga4":{"measurementId":"G-56SCQ867FW"},"gtm":{"tagId":"GTM-5SRVH4P"}},"contextual":{"options":["chatgpt","claude","copy","view",{"title":"Open in Discord","description":"Join our Discord community","icon":"discord","href":"https://discord.com/invite/w97HT9RKCF"}],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cashfreepayments-d00050e9","hasAudioNarration":false,"actualSubdomain":"cashfreepayments-d00050e9","customDomains":["www.cashfree.com"],"gitSource":{"type":"github","owner":"cashfree","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af45504c0e883d574365db3","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Payments APIs","count":520},{"language":"default","tag":"Other Versions","count":349},{"language":"default","tag":"Payments","count":307},{"language":"default","tag":"v2026-01-01","count":159},{"language":"default","tag":"Subscription","count":151},{"language":"default","tag":"v2025-01-01","count":150},{"language":"default","tag":"v2023-08-01","count":142},{"language":"default","tag":"Payment Gateway","count":137},{"language":"default","tag":"Secure ID","count":106},{"language":"default","tag":"Payouts","count":105}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":false,"email":"documentation@cashfree.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6916d346c181a220cfa37e8d","deploymentId":"66d5827f2de686bc28e7722b","questionText":"How do I accept payments online?","status":"active","generatedBy":"manual","createdAt":"2025-11-14T06:59:18.295Z","updatedAt":"2025-11-14T06:59:18.295Z","__v":0},{"_id":"6916d306c181a220cfa370e8","deploymentId":"66d5827f2de686bc28e7722b","questionText":"What is Cashfree Hosted Checkout?","status":"active","generatedBy":"manual","createdAt":"2025-11-14T06:58:14.574Z","updatedAt":"2025-11-14T06:58:14.574Z","__v":0},{"_id":"6916d2dbc181a220cfa368a4","deploymentId":"66d5827f2de686bc28e7722b","questionText":"How do I create a payment link?","status":"active","generatedBy":"manual","createdAt":"2025-11-14T06:57:31.657Z","updatedAt":"2025-11-14T06:57:31.657Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/docs/_mintlify/custom/cashfreepayments-d00050e9/d27e7b15bbcae12a/style.css"},{"filePath":"grid.css","content":".container,.container-fluid{margin-right:auto;margin-left:auto;padding-top:3rem;padding-bottom:3rem}.container-fluid{padding-right:2rem;padding-left:2rem}.row{box-sizing:border-box;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-flex:0;-ms-flex:0 1 auto;flex:0 1 auto;-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-right:-0.5rem;margin-left:-0.5rem}.row.reverse{-webkit-box-orient:horizontal;-webkit-box-direction:reverse;-ms-flex-direction:row-reverse;flex-direction:row-reverse}.col.reverse{-webkit-box-orient:vertical;-webkit-box-direction:reverse;-ms-flex-direction:column-reverse;flex-direction:column-reverse}.col-xs,.col-xs-1,.col-xs-10,.col-xs-11,.col-xs-12,.col-xs-2,.col-xs-3,.col-xs-4,.col-xs-5,.col-xs-6,.col-xs-7,.col-xs-8,.col-xs-9,.col-xs-offset-0,.col-xs-offset-1,.col-xs-offset-10,.col-xs-offset-11,.col-xs-offset-12,.col-xs-offset-2,.col-xs-offset-3,.col-xs-offset-4,.col-xs-offset-5,.col-xs-offset-6,.col-xs-offset-7,.col-xs-offset-8,.col-xs-offset-9{box-sizing:border-box;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:0.5rem;padding-left:0.5rem}.col-xs{-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-ms-flex-preferred-size:0;flex-basis:0;max-width:100%}.col-xs-1{-ms-flex-preferred-size:8.33333333%;flex-basis:8.33333333%;max-width:8.33333333%}.col-xs-2{-ms-flex-preferred-size:16.66666667%;flex-basis:16.66666667%;max-width:16.66666667%}.col-xs-3{-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.col-xs-4{-ms-flex-preferred-size:33.33333333%;flex-basis:33.33333333%;max-width:33.33333333%}.col-xs-5{-ms-flex-preferred-size:41.66666667%;flex-basis:41.66666667%;max-width:41.66666667%}.col-xs-6{-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}.col-xs-7{-ms-flex-preferred-size:58.33333333%;flex-basis:58.33333333%;max-width:58.33333333%}.col-xs-8{-ms-flex-preferred-size:66.66666667%;flex-basis:66.66666667%;max-width:66.66666667%}.col-xs-9{-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.col-xs-10{-ms-flex-preferred-size:83.33333333%;flex-basis:83.33333333%;max-width:83.33333333%}.col-xs-11{-ms-flex-preferred-size:91.66666667%;flex-basis:91.66666667%;max-width:91.66666667%}.col-xs-12{-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.col-xs-offset-0{margin-left:0}.col-xs-offset-1{margin-left:8.33333333%}.col-xs-offset-2{margin-left:16.66666667%}.col-xs-offset-3{margin-left:25%}.col-xs-offset-4{margin-left:33.33333333%}.col-xs-offset-5{margin-left:41.66666667%}.col-xs-offset-6{margin-left:50%}.col-xs-offset-7{margin-left:58.33333333%}.col-xs-offset-8{margin-left:66.66666667%}.col-xs-offset-9{margin-left:75%}.col-xs-offset-10{margin-left:83.33333333%}.col-xs-offset-11{margin-left:91.66666667%}.start-xs{-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start;text-align:start}.center-xs{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;text-align:center}.end-xs{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;text-align:end}.top-xs{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.middle-xs{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.bottom-xs{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.around-xs{-ms-flex-pack:distribute;justify-content:space-around}.between-xs{-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.first-xs{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.last-xs{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}@media only screen and (min-width: 48em){.container{width:49rem}.col-sm,.col-sm-1,.col-sm-10,.col-sm-11,.col-sm-12,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9,.col-sm-offset-0,.col-sm-offset-1,.col-sm-offset-10,.col-sm-offset-11,.col-sm-offset-12,.col-sm-offset-2,.col-sm-offset-3,.col-sm-offset-4,.col-sm-offset-5,.col-sm-offset-6,.col-sm-offset-7,.col-sm-offset-8,.col-sm-offset-9{box-sizing:border-box;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:0.5rem;padding-left:0.5rem}.col-sm{-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-ms-flex-preferred-size:0;flex-basis:0;max-width:100%}.col-sm-1{-ms-flex-preferred-size:8.33333333%;flex-basis:8.33333333%;max-width:8.33333333%}.col-sm-2{-ms-flex-preferred-size:16.66666667%;flex-basis:16.66666667%;max-width:16.66666667%}.col-sm-3{-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.col-sm-4{-ms-flex-preferred-size:33.33333333%;flex-basis:33.33333333%;max-width:33.33333333%}.col-sm-5{-ms-flex-preferred-size:41.66666667%;flex-basis:41.66666667%;max-width:41.66666667%}.col-sm-6{-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}.col-sm-7{-ms-flex-preferred-size:58.33333333%;flex-basis:58.33333333%;max-width:58.33333333%}.col-sm-8{-ms-flex-preferred-size:66.66666667%;flex-basis:66.66666667%;max-width:66.66666667%}.col-sm-9{-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.col-sm-10{-ms-flex-preferred-size:83.33333333%;flex-basis:83.33333333%;max-width:83.33333333%}.col-sm-11{-ms-flex-preferred-size:91.66666667%;flex-basis:91.66666667%;max-width:91.66666667%}.col-sm-12{-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.col-sm-offset-0{margin-left:0}.col-sm-offset-1{margin-left:8.33333333%}.col-sm-offset-2{margin-left:16.66666667%}.col-sm-offset-3{margin-left:25%}.col-sm-offset-4{margin-left:33.33333333%}.col-sm-offset-5{margin-left:41.66666667%}.col-sm-offset-6{margin-left:50%}.col-sm-offset-7{margin-left:58.33333333%}.col-sm-offset-8{margin-left:66.66666667%}.col-sm-offset-9{margin-left:75%}.col-sm-offset-10{margin-left:83.33333333%}.col-sm-offset-11{margin-left:91.66666667%}.start-sm{-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start;text-align:start}.center-sm{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;text-align:center}.end-sm{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;text-align:end}.top-sm{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.middle-sm{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.bottom-sm{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.around-sm{-ms-flex-pack:distribute;justify-content:space-around}.between-sm{-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.first-sm{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.last-sm{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}}@media only screen and (min-width: 64em){.container{width:65rem}.col-md,.col-md-1,.col-md-10,.col-md-11,.col-md-12,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9,.col-md-offset-0,.col-md-offset-1,.col-md-offset-10,.col-md-offset-11,.col-md-offset-12,.col-md-offset-2,.col-md-offset-3,.col-md-offset-4,.col-md-offset-5,.col-md-offset-6,.col-md-offset-7,.col-md-offset-8,.col-md-offset-9{box-sizing:border-box;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:0.5rem;padding-left:0.5rem}.col-md{-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-ms-flex-preferred-size:0;flex-basis:0;max-width:100%}.col-md-1{-ms-flex-preferred-size:8.33333333%;flex-basis:8.33333333%;max-width:8.33333333%}.col-md-2{-ms-flex-preferred-size:16.66666667%;flex-basis:16.66666667%;max-width:16.66666667%}.col-md-3{-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.col-md-4{-ms-flex-preferred-size:33.33333333%;flex-basis:33.33333333%;max-width:33.33333333%}.col-md-5{-ms-flex-preferred-size:41.66666667%;flex-basis:41.66666667%;max-width:41.66666667%}.col-md-6{-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}.col-md-7{-ms-flex-preferred-size:58.33333333%;flex-basis:58.33333333%;max-width:58.33333333%}.col-md-8{-ms-flex-preferred-size:66.66666667%;flex-basis:66.66666667%;max-width:66.66666667%}.col-md-9{-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.col-md-10{-ms-flex-preferred-size:83.33333333%;flex-basis:83.33333333%;max-width:83.33333333%}.col-md-11{-ms-flex-preferred-size:91.66666667%;flex-basis:91.66666667%;max-width:91.66666667%}.col-md-12{-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.col-md-offset-0{margin-left:0}.col-md-offset-1{margin-left:8.33333333%}.col-md-offset-2{margin-left:16.66666667%}.col-md-offset-3{margin-left:25%}.col-md-offset-4{margin-left:33.33333333%}.col-md-offset-5{margin-left:41.66666667%}.col-md-offset-6{margin-left:50%}.col-md-offset-7{margin-left:58.33333333%}.col-md-offset-8{margin-left:66.66666667%}.col-md-offset-9{margin-left:75%}.col-md-offset-10{margin-left:83.33333333%}.col-md-offset-11{margin-left:91.66666667%}.start-md{-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start;text-align:start}.center-md{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;text-align:center}.end-md{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;text-align:end}.top-md{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.middle-md{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.bottom-md{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.around-md{-ms-flex-pack:distribute;justify-content:space-around}.between-md{-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.first-md{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.last-md{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}}@media only screen and (min-width: 75em){.container{width:76rem}.col-lg,.col-lg-1,.col-lg-10,.col-lg-11,.col-lg-12,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9,.col-lg-offset-0,.col-lg-offset-1,.col-lg-offset-10,.col-lg-offset-11,.col-lg-offset-12,.col-lg-offset-2,.col-lg-offset-3,.col-lg-offset-4,.col-lg-offset-5,.col-lg-offset-6,.col-lg-offset-7,.col-lg-offset-8,.col-lg-offset-9{box-sizing:border-box;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:0.5rem;padding-left:0.5rem}.col-lg{-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-ms-flex-preferred-size:0;flex-basis:0;max-width:100%}.col-lg-1{-ms-flex-preferred-size:8.33333333%;flex-basis:8.33333333%;max-width:8.33333333%}.col-lg-2{-ms-flex-preferred-size:16.66666667%;flex-basis:16.66666667%;max-width:16.66666667%}.col-lg-3{-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.col-lg-4{-ms-flex-preferred-size:33.33333333%;flex-basis:33.33333333%;max-width:33.33333333%}.col-lg-5{-ms-flex-preferred-size:41.66666667%;flex-basis:41.66666667%;max-width:41.66666667%}.col-lg-6{-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}.col-lg-7{-ms-flex-preferred-size:58.33333333%;flex-basis:58.33333333%;max-width:58.33333333%}.col-lg-8{-ms-flex-preferred-size:66.66666667%;flex-basis:66.66666667%;max-width:66.66666667%}.col-lg-9{-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.col-lg-10{-ms-flex-preferred-size:83.33333333%;flex-basis:83.33333333%;max-width:83.33333333%}.col-lg-11{-ms-flex-preferred-size:91.66666667%;flex-basis:91.66666667%;max-width:91.66666667%}.col-lg-12{-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.col-lg-offset-0{margin-left:0}.col-lg-offset-1{margin-left:8.33333333%}.col-lg-offset-2{margin-left:16.66666667%}.col-lg-offset-3{margin-left:25%}.col-lg-offset-4{margin-left:33.33333333%}.col-lg-offset-5{margin-left:41.66666667%}.col-lg-offset-6{margin-left:50%}.col-lg-offset-7{margin-left:58.33333333%}.col-lg-offset-8{margin-left:66.66666667%}.col-lg-offset-9{margin-left:75%}.col-lg-offset-10{margin-left:83.33333333%}.col-lg-offset-11{margin-left:91.66666667%}.start-lg{-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start;text-align:start}.center-lg{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;text-align:center}.end-lg{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;text-align:end}.top-lg{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.middle-lg{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.bottom-lg{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.around-lg{-ms-flex-pack:distribute;justify-content:space-around}.between-lg{-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.first-lg{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.last-lg{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}}"},{"filePath":"typography.css","content":".landing-page h1{font-size:2.4rem}.landing-page h2{font-size:2rem}.landing-page h3{font-size:1.6rem}.landing-page h4{font-size:1.2rem}.landing-page h5{font-size:1rem}.landing-page h6{font-size:0.8rem}.bold{font-weight:bold}.semibold{font-weight:600}.medium{font-weight:500}.regular{font-weight:400}.light{font-weight:300}"}],"page":{"pagePath":"api-reference/other-apis/bbps-cou/bill-fetch/request","slug":"/api-reference/other-apis/bbps-cou/bill-fetch/request","pageMetadata":{"title":"Bill Fetch Request","sidebarTitle":"Bill Fetch Request","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/request/bill-fetch","keywords":["bill fetch","BBPS","COU","fetch and pay","validate and pay","async"],"og:title":"Initiate Bill Fetch | Cashfree","og:description":"Initiate a BBPS bill fetch or validation request through the Cashfree COU API by providing biller ID, customer identifiers, and agent device context details.","description":"With the biller's MDM details in hand, use this API to initiate a bill fetch or validation for the customer. Pass the customer input parameters specified in the biller's MDM response, such as a consumer number or mobile number, along with the agent device context. The API automatically determines the payment flow (`FETCH_AND_PAY` or `VALIDATE_AND_PAY`) based on the biller's configuration.\n\n\u003cWarning>\nThis API is only applicable for billers whose `fetch_requirement` or `support_bill_validation` is `MANDATORY` or `OPTIONAL`. For billers where both are `NOT_SUPPORTED` (`DIRECT_PAY` flow), skip this step and proceed directly to the [Bill Payment Request API](/api-reference/other-apis/bbps-cou/bill-payment/request).\n\u003c/Warning>\n\n\u003cAccordion title=\"Flow determination logic\">\n\nThe flow is evaluated in the following priority order based on the biller's MDM configuration:\n\n| Priority | `fetch_requirement` | `support_bill_validation` | Flow |\n|---|---|---|---|\n| 1 | `MANDATORY` | Any | `FETCH_AND_PAY` |\n| 2 | `NOT_SUPPORTED` | `MANDATORY` or `OPTIONAL` | `VALIDATE_AND_PAY` |\n| 3 | `NOT_SUPPORTED` | `NOT_SUPPORTED` | `DIRECT_PAY` |\n| 4 | `OPTIONAL` | `MANDATORY` | `VALIDATE_AND_PAY` |\n| 5 | `OPTIONAL` | Any other | `FETCH_AND_PAY` |\n\nFor `DIRECT_PAY`, this API is not applicable. Calling it returns a validation error. Proceed directly to the Bill Payment Request API.\n\n\u003c/Accordion>\n\n\u003cWarning>\nWith synchronous responses enabled, handle both HTTP `200` and HTTP `202`, and set your HTTP client timeout to at least 30 seconds. For details, see [Synchronous responses](/api-reference/other-apis/bbps-cou/synchronous-responses).\n\u003c/Warning>\n\n\u003cTip>\nOnce you receive a successful bill fetch, proceed to the [Bill Payment Request API](/api-reference/other-apis/bbps-cou/bill-payment/request) to complete the payment. When polling the [Bill Fetch Response API](/api-reference/other-apis/bbps-cou/bill-fetch/response) for the result, check the biller's `biller_response_type` field from the Fetch Biller MDM Details response. If it is `LIST` (the biller can return multiple outstanding bills in a single fetch, such as traffic challans), use `x-api-version: 2026-01-01` on the response API to receive all bills in the `biller_responses` array. For all other billers, use the default `x-api-version: 2025-01-01`, which returns a single bill in `biller_response`.\n\u003c/Tip>","href":"/api-reference/other-apis/bbps-cou/bill-fetch/request","hidden":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n table: \"table\",\n tbody: \"tbody\",\n td: \"td\",\n th: \"th\",\n thead: \"thead\",\n tr: \"tr\",\n ..._provideComponents(),\n ...props.components\n }, {Accordion, Tip, Warning} = _components;\n if (!Accordion) _missingMdxReference(\"Accordion\", true);\n if (!Tip) _missingMdxReference(\"Tip\", true);\n if (!Warning) _missingMdxReference(\"Warning\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"With the biller’s MDM details in hand, use this API to initiate a bill fetch or validation for the customer. Pass the customer input parameters specified in the biller’s MDM response, such as a consumer number or mobile number, along with the agent device context. The API automatically determines the payment flow (\", _jsx(_components.code, {\n children: \"FETCH_AND_PAY\"\n }), \" or \", _jsx(_components.code, {\n children: \"VALIDATE_AND_PAY\"\n }), \") based on the biller’s configuration.\"]\n }), \"\\n\", _jsx(Warning, {\n children: _jsxs(_components.p, {\n children: [\"This API is only applicable for billers whose \", _jsx(_components.code, {\n children: \"fetch_requirement\"\n }), \" or \", _jsx(_components.code, {\n children: \"support_bill_validation\"\n }), \" is \", _jsx(_components.code, {\n children: \"MANDATORY\"\n }), \" or \", _jsx(_components.code, {\n children: \"OPTIONAL\"\n }), \". For billers where both are \", _jsx(_components.code, {\n children: \"NOT_SUPPORTED\"\n }), \" (\", _jsx(_components.code, {\n children: \"DIRECT_PAY\"\n }), \" flow), skip this step and proceed directly to the \", _jsx(_components.a, {\n href: \"/api-reference/other-apis/bbps-cou/bill-payment/request\",\n children: \"Bill Payment Request API\"\n }), \".\"]\n })\n }), \"\\n\", _jsxs(Accordion, {\n title: \"Flow determination logic\",\n children: [_jsx(_components.p, {\n children: \"The flow is evaluated in the following priority order based on the biller’s MDM configuration:\"\n }), _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n children: \"Priority\"\n }), _jsx(_components.th, {\n children: _jsx(_components.code, {\n children: \"fetch_requirement\"\n })\n }), _jsx(_components.th, {\n children: _jsx(_components.code, {\n children: \"support_bill_validation\"\n })\n }), _jsx(_components.th, {\n children: \"Flow\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: \"1\"\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"MANDATORY\"\n })\n }), _jsx(_components.td, {\n children: \"Any\"\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"FETCH_AND_PAY\"\n })\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: \"2\"\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"NOT_SUPPORTED\"\n })\n }), _jsxs(_components.td, {\n children: [_jsx(_components.code, {\n children: \"MANDATORY\"\n }), \" or \", _jsx(_components.code, {\n children: \"OPTIONAL\"\n })]\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"VALIDATE_AND_PAY\"\n })\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: \"3\"\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"NOT_SUPPORTED\"\n })\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"NOT_SUPPORTED\"\n })\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"DIRECT_PAY\"\n })\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: \"4\"\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"OPTIONAL\"\n })\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"MANDATORY\"\n })\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"VALIDATE_AND_PAY\"\n })\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: \"5\"\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"OPTIONAL\"\n })\n }), _jsx(_components.td, {\n children: \"Any other\"\n }), _jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"FETCH_AND_PAY\"\n })\n })]\n })]\n })]\n }), _jsxs(_components.p, {\n children: [\"For \", _jsx(_components.code, {\n children: \"DIRECT_PAY\"\n }), \", this API is not applicable. Calling it returns a validation error. Proceed directly to the Bill Payment Request API.\"]\n })]\n }), \"\\n\", _jsx(Warning, {\n children: _jsxs(_components.p, {\n children: [\"With synchronous responses enabled, handle both HTTP \", _jsx(_components.code, {\n children: \"200\"\n }), \" and HTTP \", _jsx(_components.code, {\n children: \"202\"\n }), \", and set your HTTP client timeout to at least 30 seconds. For details, see \", _jsx(_components.a, {\n href: \"/api-reference/other-apis/bbps-cou/synchronous-responses\",\n children: \"Synchronous responses\"\n }), \".\"]\n })\n }), \"\\n\", _jsx(Tip, {\n children: _jsxs(_components.p, {\n children: [\"Once you receive a successful bill fetch, proceed to the \", _jsx(_components.a, {\n href: \"/api-reference/other-apis/bbps-cou/bill-payment/request\",\n children: \"Bill Payment Request API\"\n }), \" to complete the payment. When polling the \", _jsx(_components.a, {\n href: \"/api-reference/other-apis/bbps-cou/bill-fetch/response\",\n children: \"Bill Fetch Response API\"\n }), \" for the result, check the biller’s \", _jsx(_components.code, {\n children: \"biller_response_type\"\n }), \" field from the Fetch Biller MDM Details response. If it is \", _jsx(_components.code, {\n children: \"LIST\"\n }), \" (the biller can return multiple outstanding bills in a single fetch, such as traffic challans), use \", _jsx(_components.code, {\n children: \"x-api-version: 2026-01-01\"\n }), \" on the response API to receive all bills in the \", _jsx(_components.code, {\n children: \"biller_responses\"\n }), \" array. For all other billers, use the default \", _jsx(_components.code, {\n children: \"x-api-version: 2025-01-01\"\n }), \", which returns a single bill in \", _jsx(_components.code, {\n children: \"biller_response\"\n }), \".\"]\n })\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Bill Fetch Request","sidebarTitle":"Bill Fetch Request","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/request/bill-fetch","keywords":["bill fetch","BBPS","COU","fetch and pay","validate and pay","async"],"og:title":"Initiate Bill Fetch | Cashfree","og:description":"Initiate a BBPS bill fetch or validation request through the Cashfree COU API by providing biller ID, customer identifiers, and agent device context details.","description":"With the biller's MDM details in hand, use this API to initiate a bill fetch or validation for the customer. Pass the customer input parameters specified in the biller's MDM response, such as a consumer number or mobile number, along with the agent device context. The API automatically determines the payment flow (`FETCH_AND_PAY` or `VALIDATE_AND_PAY`) based on the biller's configuration.\n\n\u003cWarning>\nThis API is only applicable for billers whose `fetch_requirement` or `support_bill_validation` is `MANDATORY` or `OPTIONAL`. For billers where both are `NOT_SUPPORTED` (`DIRECT_PAY` flow), skip this step and proceed directly to the [Bill Payment Request API](/api-reference/other-apis/bbps-cou/bill-payment/request).\n\u003c/Warning>\n\n\u003cAccordion title=\"Flow determination logic\">\n\nThe flow is evaluated in the following priority order based on the biller's MDM configuration:\n\n| Priority | `fetch_requirement` | `support_bill_validation` | Flow |\n|---|---|---|---|\n| 1 | `MANDATORY` | Any | `FETCH_AND_PAY` |\n| 2 | `NOT_SUPPORTED` | `MANDATORY` or `OPTIONAL` | `VALIDATE_AND_PAY` |\n| 3 | `NOT_SUPPORTED` | `NOT_SUPPORTED` | `DIRECT_PAY` |\n| 4 | `OPTIONAL` | `MANDATORY` | `VALIDATE_AND_PAY` |\n| 5 | `OPTIONAL` | Any other | `FETCH_AND_PAY` |\n\nFor `DIRECT_PAY`, this API is not applicable. Calling it returns a validation error. Proceed directly to the Bill Payment Request API.\n\n\u003c/Accordion>\n\n\u003cWarning>\nWith synchronous responses enabled, handle both HTTP `200` and HTTP `202`, and set your HTTP client timeout to at least 30 seconds. For details, see [Synchronous responses](/api-reference/other-apis/bbps-cou/synchronous-responses).\n\u003c/Warning>\n\n\u003cTip>\nOnce you receive a successful bill fetch, proceed to the [Bill Payment Request API](/api-reference/other-apis/bbps-cou/bill-payment/request) to complete the payment. When polling the [Bill Fetch Response API](/api-reference/other-apis/bbps-cou/bill-fetch/response) for the result, check the biller's `biller_response_type` field from the Fetch Biller MDM Details response. If it is `LIST` (the biller can return multiple outstanding bills in a single fetch, such as traffic challans), use `x-api-version: 2026-01-01` on the response API to receive all bills in the `biller_responses` array. For all other billers, use the default `x-api-version: 2025-01-01`, which returns a single bill in `biller_response`.\n\u003c/Tip>","href":"/api-reference/other-apis/bbps-cou/bill-fetch/request","hidden":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/cashfreepayments-d00050e9/0a1efd0b138512b4/util/downloadImages.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/7b49b0aba32ccd66/util/checkLinks.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/6520965c686ab08e/util/updateFrontmatter.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/e6313895ea4c2bf0/export-docs/export.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/6459e4b38b43a234/export-docs/sync-kb.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/82d5b75dd1e333d2/snippets/postman-buttons/postman-links.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/e8f71dc9fab8d95d/scripts/ga4-video-tracking.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/e3b0c44298fc1c14/scripts/generate-postman-buttons.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/bc4eac15553663a2/scripts/openapi-rm-desc.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/5748000362acad1e/scripts/quote-openapi.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/0a7365ce97b5cca7/scripts/script.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/d99a96c0c4b010fe/scripts/updateHelpAccordionsWithPostHog.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/bd8561d01634fd2e/scripts/updateIframeSrc.js"],"openApiReferenceData":{"operation":{"summary":"Bill Fetch Request","description":"With the biller's MDM details in hand, use this API to initiate a bill fetch or validation for the customer. Pass the customer input parameters specified in the biller's MDM response, such as a consumer number or mobile number, along with the agent device context. The API automatically determines the payment flow (`FETCH_AND_PAY` or `VALIDATE_AND_PAY`) based on the biller's configuration.\n\n\u003cWarning>\nThis API is only applicable for billers whose `fetch_requirement` or `support_bill_validation` is `MANDATORY` or `OPTIONAL`. For billers where both are `NOT_SUPPORTED` (`DIRECT_PAY` flow), skip this step and proceed directly to the [Bill Payment Request API](/api-reference/other-apis/bbps-cou/bill-payment/request).\n\u003c/Warning>\n\n\u003cAccordion title=\"Flow determination logic\">\n\nThe flow is evaluated in the following priority order based on the biller's MDM configuration:\n\n| Priority | `fetch_requirement` | `support_bill_validation` | Flow |\n|---|---|---|---|\n| 1 | `MANDATORY` | Any | `FETCH_AND_PAY` |\n| 2 | `NOT_SUPPORTED` | `MANDATORY` or `OPTIONAL` | `VALIDATE_AND_PAY` |\n| 3 | `NOT_SUPPORTED` | `NOT_SUPPORTED` | `DIRECT_PAY` |\n| 4 | `OPTIONAL` | `MANDATORY` | `VALIDATE_AND_PAY` |\n| 5 | `OPTIONAL` | Any other | `FETCH_AND_PAY` |\n\nFor `DIRECT_PAY`, this API is not applicable. Calling it returns a validation error. Proceed directly to the Bill Payment Request API.\n\n\u003c/Accordion>\n\n\u003cWarning>\nWith synchronous responses enabled, handle both HTTP `200` and HTTP `202`, and set your HTTP client timeout to at least 30 seconds. For details, see [Synchronous responses](/api-reference/other-apis/bbps-cou/synchronous-responses).\n\u003c/Warning>\n\n\u003cTip>\nOnce you receive a successful bill fetch, proceed to the [Bill Payment Request API](/api-reference/other-apis/bbps-cou/bill-payment/request) to complete the payment. When polling the [Bill Fetch Response API](/api-reference/other-apis/bbps-cou/bill-fetch/response) for the result, check the biller's `biller_response_type` field from the Fetch Biller MDM Details response. If it is `LIST` (the biller can return multiple outstanding bills in a single fetch, such as traffic challans), use `x-api-version: 2026-01-01` on the response API to receive all bills in the `biller_responses` array. For all other billers, use the default `x-api-version: 2025-01-01`, which returns a single bill in `biller_response`.\n\u003c/Tip>","operationId":"billFetchRequest","tags":["Bill Fetch"],"parameters":["acd0c48f-1ecc-41d7-b4ea-7aecbf2c1332"],"requestBody":"f3bdb3d4-42ec-4246-ae09-42511472952f","responses":{"200":"f9b09976-9e60-4a54-9485-d4c2c0936685","202":"343e3475-5d17-42e3-a0fe-d934b8011b71","400":"d20fb14b-e4ea-4cde-a09b-11596454c1fe","401":"c763a321-0f26-43f4-bc0b-4c4c9e01c69d","429":"3c9e942d-c36f-4092-bda1-2590cb451b97","500":"59754314-7e0d-4f71-8fe5-e69174692924"},"method":"post","type":"path","servers":["56f30b48-ddef-49d1-ab37-3936f3a9a2e8","8ca8449d-2cdf-4d19-9ac4-123ee45c80de"],"security":["71bee65a-6345-4852-967d-e1877f72fbf5"],"path":"/bbps/cou/v1/billers/request/bill-fetch","baseUrlOptions":["https://sandbox.cashfree.com","https://api.cashfree.com"],"title":"Bill Fetch Request","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"acd0c48f-1ecc-41d7-b4ea-7aecbf2c1332":{"in":"header","name":"x-api-version","required":false,"description":"API version to be used. Format is YYYY-MM-DD. The only supported version for this API is `2025-01-01`. If not specified, `2025-01-01` is used.\n","schema":{"type":"string","default":"2025-01-01","enum":["2025-01-01"],"isRequired":false,"description":"API version to be used. Format is YYYY-MM-DD. The only supported version for this API is `2025-01-01`. If not specified, `2025-01-01` is used.\n","uniqueKey":"","typeLabel":"enum\u003cstring>"},"example":"2025-01-01"}},"requestBody":{"description":"Request parameters to initiate a bill fetch or bill validation request.","required":true,"content":{"application/json":{"schema":{"type":"object","required":["bill_fetch_request"],"properties":{"bill_fetch_request":{"type":"object","required":["agent_id","biller_id","input_params"],"properties":{"agent_id":{"type":"string","description":"Unique ID assigned to your BBPS agent upon registration at NBBL. This is provided to you after your onboarding and agent creation at NBBL. Contact your Cashfree account manager if you have not received this.","example":"OU01XXXXINT001123456","isRequired":true,"uniqueKey":"bill_fetch_request.agent_id","typeLabel":"string"},"biller_id":{"type":"string","description":"Biller ID as returned by the Fetch Biller MDM Details API.","example":"VODA00000MUM03","isRequired":true,"uniqueKey":"bill_fetch_request.biller_id","typeLabel":"string"},"input_params":{"type":"object","required":["input"],"description":"Customer identifiers matching the biller configuration.","properties":{"input":{"type":"array","description":"Array of customer identifier key-value pairs required by the biller. Each object contains one customer parameter. The parameters to collect and their validation rules are defined in the `biller_customer_params` array returned by the Fetch Biller MDM Details API for this biller.","minItems":1,"items":{"type":"object","required":["param_name","param_value"],"properties":{"param_name":{"type":"string","description":"The customer identifier the biller uses to look up the account. The parameter name must exactly match the value returned in the `biller_customer_params` array of the Fetch Biller MDM Details API response for this biller. Submit one input object per required customer parameter.","example":"Loan Account Number","isRequired":true,"uniqueKey":"bill_fetch_request.input_params.input.items.[INDEX].param_name","typeLabel":"string"},"param_value":{"type":"string","description":"The customer's input value for the corresponding `param_name`. Must conform to the `data_type`, `min_length`, `max_length`, and `regex` constraints defined in the biller's MDM configuration.","example":"LN00123456","isRequired":true,"uniqueKey":"bill_fetch_request.input_params.input.items.[INDEX].param_value","typeLabel":"string"}},"uniqueKey":"bill_fetch_request.input_params.input.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"bill_fetch_request.input_params.input","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"bill_fetch_request.input_params","typeLabel":"object"},"agent_device_info":{"type":"object","description":"Device and channel metadata for the device initiating the bill fetch request on behalf of the customer. Required by BBPS for audit and compliance purposes. Mandatory for FETCH_AND_PAY. Optional for VALIDATE_AND_PAY. At least one sub-field must be non-null. The `init_channel` field determines which sub-fields are mandatory and which payment modes are supported.\n","properties":{"init_channel":{"type":"string","description":"Initiating channel through which the bill fetch request originates. Only the following three channels are supported:\n\n**`MOBB` — Mobile Banking (Post-login)**\nRequired device block tags: `ip`, `imei`, `os`, `app`\nSupported payment modes: Internet Banking, Credit Card, Debit Card, Prepaid Card, UPI, Wallet, AEPS, USSD, CBDC\n\n**`INTB` — Internet Banking (Post-login)**\nRequired device block tags: `ip`, `mac`\nSupported payment modes: Internet Banking, Credit Card, Debit Card, Prepaid Card, UPI, Wallet, CBDC\n\n**`AGT` — Agent**\nRequired device block tags: `terminal_id`, `mobile`, `geo_code`, `postal_code`\nSupported payment modes: Cash, Credit Card, Debit Card, Prepaid Card, UPI, AEPS, Bharat QR, CBDC\n","enum":["MOBB","INTB","AGT"],"example":"INTB","uniqueKey":"bill_fetch_request.agent_device_info.init_channel","typeLabel":"enum\u003cstring>"},"ip":{"type":"string","description":"IP address of the device initiating the request.","example":"124.170.23.22","uniqueKey":"bill_fetch_request.agent_device_info.ip","typeLabel":"string"},"mobile":{"type":"string","description":"Mobile number of the agent device.","example":"9830098300","uniqueKey":"bill_fetch_request.agent_device_info.mobile","typeLabel":"string"},"geo_code":{"type":"string","description":"GPS coordinates of the device in \"latitude,longitude\" format.","example":"12.9667,77.5667","uniqueKey":"bill_fetch_request.agent_device_info.geo_code","typeLabel":"string"},"postal_code":{"type":"string","description":"Postal code of the device location.","example":"400063","uniqueKey":"bill_fetch_request.agent_device_info.postal_code","typeLabel":"string"},"terminal_id":{"type":"string","description":"Unique terminal identifier for the agent device.","example":"1234556","uniqueKey":"bill_fetch_request.agent_device_info.terminal_id","typeLabel":"string"},"imei":{"type":"string","description":"IMEI number of the mobile device.","example":"123456789012345","uniqueKey":"bill_fetch_request.agent_device_info.imei","typeLabel":"string"},"ifsc":{"type":"string","description":"IFSC code of the agent's bank branch.","example":"ABCD0001234","uniqueKey":"bill_fetch_request.agent_device_info.ifsc","typeLabel":"string"},"mac":{"type":"string","description":"MAC address of the device.","example":"00-0D-60-07-2A-F0","uniqueKey":"bill_fetch_request.agent_device_info.mac","typeLabel":"string"},"os":{"type":"string","description":"Operating system of the device. Example values are iOS and Android.","example":"iOS","uniqueKey":"bill_fetch_request.agent_device_info.os","typeLabel":"string"},"app":{"type":"string","description":"Name of the agent application initiating the request.","example":"AGENTAPP","uniqueKey":"bill_fetch_request.agent_device_info.app","typeLabel":"string"}},"uniqueKey":"bill_fetch_request.agent_device_info","typeLabel":"object"},"customer_info":{"type":"object","description":"Personal details of the customer for whom the bill fetch is being initiated. Used by the biller to associate the request with a customer account. Mandatory for `FETCH_AND_PAY`. Optional for `VALIDATE_AND_PAY`.","required":["customer_mobile"],"properties":{"customer_mobile":{"type":"string","description":"Mobile number of the customer initiating the bill fetch.","example":"9505XXXX98","isRequired":true,"uniqueKey":"bill_fetch_request.customer_info.customer_mobile","typeLabel":"string"},"customer_email":{"type":"string","description":"Customer's email address.","example":"customer@example.com","uniqueKey":"bill_fetch_request.customer_info.customer_email","typeLabel":"string"},"aadhaar":{"type":"string","description":"Customer's 12-digit Aadhaar number.","example":"123456789012","uniqueKey":"bill_fetch_request.customer_info.aadhaar","typeLabel":"string"},"pan":{"type":"string","description":"Customer's PAN card number.","example":"BXXCG7754K","uniqueKey":"bill_fetch_request.customer_info.pan","typeLabel":"string"}},"uniqueKey":"bill_fetch_request.customer_info","typeLabel":"object"}},"isRequired":true,"uniqueKey":"bill_fetch_request","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"bill_fetch_request":{"agent_id":"CH01CH02INB516193127","biller_id":"SWAR00027NAT2J","agent_device_info":{"init_channel":"INTB","ip":"124.170.23.24","mac":"01-23-45-67-89-ab"},"customer_info":{"customer_mobile":"9958732581"},"input_params":{"input":[{"param_name":"Loan Account Number","param_value":"LN0098765444"},{"param_name":"Mobile Number","param_value":"7428771693"}]}}},"examples":{"Example":{"title":"Example","value":{"bill_fetch_request":{"agent_id":"CH01CH02INB516193127","biller_id":"SWAR00027NAT2J","agent_device_info":{"init_channel":"INTB","ip":"124.170.23.24","mac":"01-23-45-67-89-ab"},"customer_info":{"customer_mobile":"9958732581"},"input_params":{"input":[{"param_name":"Loan Account Number","param_value":"LN0098765444"},{"param_name":"Mobile Number","param_value":"7428771693"}]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f9b09976-9e60-4a54-9485-d4c2c0936685":{"description":"Final result returned in the same call. Returned only when synchronous responses are enabled for your account and the result is ready within the synchronous wait period.","headers":{"x-api-version":{"schema":{"type":"string","format":"YYYY-MM-DD","enum":["2025-01-01","2026-01-01"]},"description":"The API version used to process this request, echoed back in the response."}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"The status of the API call. Returns `OK` when the request is successfully processed and the final result is available in the same call. This field indicates the API call succeeded. The outcome of the bill fetch operation is available in the `data` object.","example":"OK","uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","description":"Final outcome of the bill fetch or bill validation request. The possible values match the `message` values that the Bill Fetch Response API returns.","enum":["Bill details fetched successfully","Bill request failed"],"uniqueKey":"message","typeLabel":"enum\u003cstring>"},"data":{"type":"object","description":"Contains the final result of the bill fetch request.","properties":{"ref_id":{"type":"string","description":"Unique reference ID for this request. Can be used to fetch the result from the Bill Fetch Response API if needed.","example":"9c9c176478db40f6b029f8ddbba62901806","uniqueKey":"data.ref_id","typeLabel":"string"},"status":{"type":"string","description":"Final status of the bill fetch or validation. `SUCCESS` indicates the biller returned the bill details (for FETCH_AND_PAY) or validated the customer's identity (for VALIDATE_AND_PAY). `FAILED` indicates the biller rejected the request. Check `result.bill_fetch_response.response_reason` and `compliance_reason` for the failure details.","enum":["SUCCESS","FAILED"],"example":"SUCCESS","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"flow":{"type":"string","description":"Payment flow determined by the biller's MDM configuration. Store this value because it determines which fields to expect in `data.result`.","enum":["FETCH_AND_PAY","VALIDATE_AND_PAY"],"example":"FETCH_AND_PAY","uniqueKey":"data.flow","typeLabel":"enum\u003cstring>"},"result":{"type":"object","description":"Final result of the request, in the same format as the `data` object returned by the [Bill Fetch Response API](/api-reference/other-apis/bbps-cou/bill-fetch/response) for the same `ref_id`. Present only in HTTP `200` responses.","uniqueKey":"data.result","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"success_fetch_and_pay":{"title":"success_fetch_and_pay","value":{"status":"OK","message":"Bill details fetched successfully","data":{"ref_id":"9c9c176478db40f6b029f8ddbba62901806","status":"SUCCESS","flow":"FETCH_AND_PAY","result":{"bill_fetch_response":{"ref_id":"9c9c176478db40f6b029f8ddbba62901806","approval_ref_num":"SBOX-REF-45bce5fdbcc34c24","response_code":"000","response_reason":"Successful","compliance_resp_cd":"","compliance_reason":""},"bill_details":{"customer_params":{"tag":[{"name":"Loan Account Number","value":"PANFNLdFrpFY66KkGzL3"},{"name":"Mobile Number","value":"6286042303"}]}},"biller_response":{"customer_name":"Sbox Test Customer","amount":"100.00","cust_conv_fee":"","due_date":"2026-11-16","bill_date":"2026-10-16","bill_number":"SBOX-REF-45bce5fdbcc34c24","bill_period":"MONTHLY","tag":null},"additional_info":null}}}},"success_validate_and_pay":{"title":"success_validate_and_pay","value":{"status":"OK","message":"Bill details fetched successfully","data":{"ref_id":"HENSVVR4QOS7X1UGPY7JGUV444P10102202","status":"SUCCESS","flow":"VALIDATE_AND_PAY","result":{"bill_fetch_response":{"ref_id":"HENSVVR4QOS7X1UGPY7JGUV444P10102202","approval_ref_num":"AB123456","response_code":"000","response_reason":"Successful"},"additional_info":null}}}},"failed":{"title":"failed","value":{"status":"OK","message":"Bill request failed","data":{"ref_id":"b0b8b97547b944b985eb196358462451850","status":"FAILED","flow":"FETCH_AND_PAY","result":{"bill_fetch_response":{"ref_id":"b0b8b97547b944b985eb196358462451850","approval_ref_num":"","response_code":"200","response_reason":"Failure","compliance_resp_cd":"BFR004","compliance_reason":"Payment received for the billing period - no bill due"},"bill_details":null,"biller_response":null,"additional_info":null}}}}},"exampleType":"examples"}},"exampleType":"examples"},"343e3475-5d17-42e3-a0fe-d934b8011b71":{"description":"The bill fetch request has been accepted and queued for processing. Use the `ref_id` in the response to poll the Bill Fetch Response API for the result. If synchronous responses are enabled for your account, this status indicates the result was not ready within the synchronous wait period. Fall back to polling.","headers":{"x-api-version":{"schema":{"type":"string","format":"YYYY-MM-DD","enum":["2025-01-01","2026-01-01"]},"description":"The API version used to process this request, echoed back in the response."}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"The status of the API call. Returns `ACCEPTED` when the request is successfully queued for processing. This field indicates the API call succeeded. Poll the Bill Fetch Response API using the `ref_id` in the `data` object for the final result.","example":"ACCEPTED","uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","description":"Confirmation that the request has been accepted and queued for processing.","example":"Bill fetch request accepted for processing","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","description":"Acknowledgement data returned immediately upon request acceptance.","properties":{"ref_id":{"type":"string","description":"Unique reference ID for this request. Use this to poll the Bill Fetch Response API.","example":"9c9c176478db40f6b029f8ddbba62901806","uniqueKey":"data.ref_id","typeLabel":"string"},"status":{"type":"string","description":"Processing status of the request. Always \"PROCESSING\" at this stage.","example":"PROCESSING","uniqueKey":"data.status","typeLabel":"string"},"flow":{"type":"string","description":"Payment flow determined by the biller's MDM configuration. Store this value because it determines which fields to expect in the Bill Fetch Response.","enum":["FETCH_AND_PAY","VALIDATE_AND_PAY","DIRECT_PAY"],"example":"FETCH_AND_PAY","uniqueKey":"data.flow","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"ACCEPTED","message":"Bill fetch request accepted for processing","data":{"ref_id":"9c9c176478db40f6b029f8ddbba62901806","status":"PROCESSING","flow":"FETCH_AND_PAY"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d20fb14b-e4ea-4cde-a09b-11596454c1fe":{"description":"Bad request error.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A description of the error explaining what went wrong.","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"An error code identifying the specific validation failure. Use this to handle errors programmatically.","uniqueKey":"code","typeLabel":"string"},"type":{"type":"string","description":"The category of the error indicating the class of failure.","uniqueKey":"type","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"bill_fetch_request.biller_id : is missing in the request. Value received: ","code":"bill_fetch_request.biller_id_missing","type":"invalid_request_error"},"examples":{"Example":{"title":"Example","value":{"message":"bill_fetch_request.biller_id : is missing in the request. Value received: ","code":"bill_fetch_request.biller_id_missing","type":"invalid_request_error"}}},"exampleType":"examples"}},"exampleType":"examples"},"c763a321-0f26-43f4-bc0b-4c4c9e01c69d":{"description":"Authentication Error.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A description of the error explaining what went wrong.","example":"authentication Failed","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"An error code identifying the specific failure. Use this to handle errors programmatically.","example":"request_failed","uniqueKey":"code","typeLabel":"string"},"type":{"type":"string","description":"The category of the error indicating the class of failure.","example":"authentication_error","uniqueKey":"type","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"authentication Failed","code":"request_failed","type":"authentication_error"}}},"exampleType":"generated"}},"exampleType":"generated"},"3c9e942d-c36f-4092-bda1-2590cb451b97":{"description":"Rate Limit Error.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A description of the error explaining what went wrong.","example":"Too many requests from IP. Check headers","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"An error code identifying the specific failure. Use this to handle errors programmatically.","example":"request_failed","uniqueKey":"code","typeLabel":"string"},"type":{"type":"string","description":"The category of the error indicating the class of failure.","example":"rate_limit_error","uniqueKey":"type","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Too many requests from IP. Check headers","code":"request_failed","type":"rate_limit_error"}}},"exampleType":"generated"}},"exampleType":"generated"},"59754314-7e0d-4f71-8fe5-e69174692924":{"description":"Internal Server Error.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A description of the error explaining what went wrong.","example":"internal Server Error","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"An error code identifying the specific failure. Use this to handle errors programmatically.","example":"internal_error","uniqueKey":"code","typeLabel":"string"},"type":{"type":"string","description":"The category of the error indicating the class of failure.","example":"api_error","uniqueKey":"type","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"internal Server Error","code":"internal_error","type":"api_error"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"71bee65a-6345-4852-967d-e1877f72fbf5":{"XClientID":{"type":"apiKey","in":"header","name":"x-client-id","description":"Your unique client identifier issued by Cashfree. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).","scopes":[],"schemeName":"XClientID"},"XClientSecret":{"type":"apiKey","in":"header","name":"x-client-secret","description":"Your unique client secret issued by Cashfree. Keep this confidential and never expose it in client-side code. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).","scopes":[],"schemeName":"XClientSecret"}}},"servers":{"56f30b48-ddef-49d1-ab37-3936f3a9a2e8":{"url":"https://sandbox.cashfree.com","description":"Sandbox (Testing) environment."},"8ca8449d-2cdf-4d19-9ac4-123ee45c80de":{"url":"https://api.cashfree.com","description":"Production environment."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-client-id","description":"Your unique client identifier issued by Cashfree. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).","scopes":[],"schemeName":"XClientID"},"schema":{"title":"x-client-id","type":"string","description":"Your unique client identifier issued by Cashfree. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"XClientID","name":"x-client-id"},{"scheme":{"type":"apiKey","in":"header","name":"x-client-secret","description":"Your unique client secret issued by Cashfree. Keep this confidential and never expose it in client-side code. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).","scopes":[],"schemeName":"XClientSecret"},"schema":{"title":"x-client-secret","type":"string","description":"Your unique client secret issued by Cashfree. Keep this confidential and never expose it in client-side code. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"XClientSecret","name":"x-client-secret"}],"title":"XClientID \u0026 XClientSecret"}]},"originalFileLocation":"openapi/bbps/bbps-cou.yaml"},"subdomain":"cashfreepayments-d00050e9","siteName":"Cashfree Developer Documentation","title":"Initiate Bill Fetch | Cashfree","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"manual"},"contextualStarterQuestions":[{"_id":"6ae1f7d7dca88a7a8ab235e8","deploymentId":"66d5827f2de686bc28e7722b","questionText":"What happens after bill fetch?","status":"active","generatedBy":"contextual","path":"api-reference/other-apis/bbps-cou/bill-fetch/request","createdAt":"2026-10-28T13:25:43.182Z","updatedAt":"2026-10-28T13:25:43.182Z","__v":0},{"_id":"6ae1f7d7dca88a7a8ab235e6","deploymentId":"66d5827f2de686bc28e7722b","questionText":"When should I use this API?","status":"active","generatedBy":"contextual","path":"api-reference/other-apis/bbps-cou/bill-fetch/request","createdAt":"2026-10-28T13:25:43.182Z","updatedAt":"2026-10-28T13:25:43.182Z","__v":0},{"_id":"6ae1f7d7dca88a7a8ab235e7","deploymentId":"66d5827f2de686bc28e7722b","questionText":"How is the payment flow determined?","status":"active","generatedBy":"contextual","path":"api-reference/other-apis/bbps-cou/bill-fetch/request","createdAt":"2026-10-28T13:25:43.182Z","updatedAt":"2026-10-28T13:25:43.182Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T13:25:33.393Z","originalFileLocation":"api-reference/other-apis/bbps-cou/bill-fetch/request.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"With the biller\u0026#x27;s MDM details in hand, use this API to initiate a bill fetch or validation for the customer. Pass the customer input parameters specified in the biller\u0026#x27;s MDM response, such as a consumer number or mobile number, along with the agent device context. The API automatically determines the payment flow (FETCH_AND_PAY or VALIDATE_AND_PAY) based on the biller\u0026#x27;s configuration. This API is only applicable for billers whose fetch_requirement or support_bill_validation is MANDATORY or OPTIONAL. For billers where both are NOT_SUPPORTED (DIRECT_PAY flow), skip this step and proceed directly to the Bill Payment Request API. The flow is evaluated in the following priority order based on the biller\u0026#x27;s MDM configuration: | Priority | fetch_requirement | support_bill_validation | Flow | |---|---|---|---| | 1 | MANDATORY | Any | FETCH_AND_PAY | | 2 | NOT_SUPPORTED | MANDATORY or OPTIONAL | VALIDATE_AND_PAY | | 3 | NOT_SUPPORTED | NOT_SUPPORTED | DIRECT_PAY | | 4 | OPTIONAL | MANDATORY | VALIDATE_AND_PAY | | 5 | OPTIONAL | Any other | FETCH_AND_PAY | For DIRECT_PAY, this API is not applicable. Calling it returns a validation error. Proceed directly to the Bill Payment Request API. With synchronous responses enabled, handle both HTTP 200 and HTTP 202, and set your HTTP client timeout to at least 30 seconds. For details, see Synchronous responses. Once you receive a successful bill fetch, proceed to the Bill Payment Request API to complete the payment. When polling the Bill Fetch Response API for the result, check the biller\u0026#x27;s biller_response_type field from the Fetch Biller MDM Details response. If it is LIST (the biller can return multiple outstanding bills in a single fetch, such as traffic challans), use x-api-version: 2026-01-01 on the response API to receive all bills in the biller_responses array. For all other billers, use the default x-api-version: 2025-01-01, which returns a single bill in biller_response.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cashfree Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Initiate Bill Fetch | Cashfree\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initiate a BBPS bill fetch or validation request through the Cashfree COU API by providing biller ID, customer identifiers, and agent device context details.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cashfree Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cashfreepayments-d00050e9.mintlify.site/docs/_mintlify/api/og/v2?division=Bill+Fetch\u0026amp;title=Bill+Fetch+Request\u0026amp;description=With+the+biller%27s+MDM+details+in+hand%2C+use+this+API+to+initiate+a+bill+fetch+or+validation+for+the+customer.+Pass+the+customer+input+parameters+specified+in+the\u0026amp;theme=977e1513659fc78ed9084d30\u0026amp;signature=1202a574c87ef6c70cb2d0a09a94a52ecb998b8a10d2b002894b61a737866d9b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Initiate Bill Fetch | Cashfree\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initiate a BBPS bill fetch or validation request through the Cashfree COU API by providing biller ID, customer identifiers, and agent device context details.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cashfreepayments-d00050e9.mintlify.site/docs/_mintlify/api/og/v2?division=Bill+Fetch\u0026amp;title=Bill+Fetch+Request\u0026amp;description=With+the+biller%27s+MDM+details+in+hand%2C+use+this+API+to+initiate+a+bill+fetch+or+validation+for+the+customer.+Pass+the+customer+input+parameters+specified+in+the\u0026amp;theme=977e1513659fc78ed9084d30\u0026amp;signature=1202a574c87ef6c70cb2d0a09a94a52ecb998b8a10d2b002894b61a737866d9b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cashfree Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6930ca\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"T69Ao_T0Ps8pkRbluKzW179qvd_aCsWISCApeSsIhRU\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/other-apis/bbps-cou/bill-fetch/request.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.cashfree.com/#organization\",\"name\":\"Cashfree Developer Documentation\",\"url\":\"https://www.cashfree.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cashfreepayments-d00050e9/6mQw7is1us8FhXrb/static/logo/light.svg?fit=max\u0026auto=format\u0026n=6mQw7is1us8FhXrb\u0026q=85\u0026s=8a2837083063d8a01e0be6b454a1baf1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.cashfree.com/docs#website\",\"name\":\"Cashfree Developer Documentation\",\"url\":\"https://www.cashfree.com/docs\",\"publisher\":{\"@id\":\"https://www.cashfree.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request#webpage\",\"url\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request\",\"name\":\"Bill Fetch Request\",\"description\":\"With the biller's MDM details in hand, use this API to initiate a bill fetch or validation for the customer. Pass the customer input parameters specified in the biller's MDM response, such as a consumer number or mobile number, along with the agent device context. The API automatically determines the payment flow (FETCH_AND_PAY or VALIDATE_AND_PAY) based on the biller's configuration. This API is only applicable for billers whose fetch_requirement or support_bill_validation is MANDATORY or OPTIONAL. For billers where both are NOT_SUPPORTED (DIRECT_PAY flow), skip this step and proceed directly to the Bill Payment Request API. The flow is evaluated in the following priority order based on the biller's MDM configuration: | Priority | fetch_requirement | support_bill_validation | Flow | |---|---|---|---| | 1 | MANDATORY | Any | FETCH_AND_PAY | | 2 | NOT_SUPPORTED | MANDATORY or OPTIONAL | VALIDATE_AND_PAY | | 3 | NOT_SUPPORTED | NOT_SUPPORTED | DIRECT_PAY | | 4 | OPTIONAL | MANDATORY | VALIDATE_AND_PAY | | 5 | OPTIONAL | Any other | FETCH_AND_PAY | For DIRECT_PAY, this API is not applicable. Calling it returns a validation error. Proceed directly to the Bill Payment Request API. With synchronous responses enabled, handle both HTTP 200 and HTTP 202, and set your HTTP client timeout to at least 30 seconds. For details, see Synchronous responses. Once you receive a successful bill fetch, proceed to the Bill Payment Request API to complete the payment. When polling the Bill Fetch Response API for the result, check the biller's biller_response_type field from the Fetch Biller MDM Details response. If it is LIST (the biller can return multiple outstanding bills in a single fetch, such as traffic challans), use x-api-version: 2026-01-01 on the response API to receive all bills in the biller_responses array. For all other billers, use the default x-api-version: 2025-01-01, which returns a single bill in biller_response.\",\"dateModified\":\"2026-10-28T13:25:33.393Z\",\"isPartOf\":{\"@id\":\"https://www.cashfree.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"BBPS for Customers\",\"item\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Bill Fetch Request\",\"item\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request#apireference\",\"headline\":\"Bill Fetch Request\",\"name\":\"Bill Fetch Request\",\"description\":\"With the biller's MDM details in hand, use this API to initiate a bill fetch or validation for the customer. Pass the customer input parameters specified in the biller's MDM response, such as a consumer number or mobile number, along with the agent device context. The API automatically determines the payment flow (FETCH_AND_PAY or VALIDATE_AND_PAY) based on the biller's configuration. This API is only applicable for billers whose fetch_requirement or support_bill_validation is MANDATORY or OPTIONAL. For billers where both are NOT_SUPPORTED (DIRECT_PAY flow), skip this step and proceed directly to the Bill Payment Request API. The flow is evaluated in the following priority order based on the biller's MDM configuration: | Priority | fetch_requirement | support_bill_validation | Flow | |---|---|---|---| | 1 | MANDATORY | Any | FETCH_AND_PAY | | 2 | NOT_SUPPORTED | MANDATORY or OPTIONAL | VALIDATE_AND_PAY | | 3 | NOT_SUPPORTED | NOT_SUPPORTED | DIRECT_PAY | | 4 | OPTIONAL | MANDATORY | VALIDATE_AND_PAY | | 5 | OPTIONAL | Any other | FETCH_AND_PAY | For DIRECT_PAY, this API is not applicable. Calling it returns a validation error. Proceed directly to the Bill Payment Request API. With synchronous responses enabled, handle both HTTP 200 and HTTP 202, and set your HTTP client timeout to at least 30 seconds. For details, see Synchronous responses. Once you receive a successful bill fetch, proceed to the Bill Payment Request API to complete the payment. When polling the Bill Fetch Response API for the result, check the biller's biller_response_type field from the Fetch Biller MDM Details response. If it is LIST (the biller can return multiple outstanding bills in a single fetch, such as traffic challans), use x-api-version: 2026-01-01 on the response API to receive all bills in the biller_responses array. For all other billers, use the default x-api-version: 2025-01-01, which returns a single bill in biller_response.\",\"url\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request\",\"mainEntityOfPage\":{\"@id\":\"https://www.cashfree.com/docs/api-reference/other-apis/bbps-cou/bill-fetch/request#webpage\"},\"dateModified\":\"2026-10-28T13:25:33.393Z\",\"keywords\":\"bill fetch, BBPS, COU, fetch and pay, validate and pay, async\",\"publisher\":{\"@id\":\"https://www.cashfree.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.cashfree.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cashfree Developer Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cashfree Developer Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/other-apis/bbps-cou/bill-fetch/request.md","siteName":"Cashfree Developer Documentation","nav":{"global":null,"tabs":[{"tab":"Payments","pages":[{"title":"Payments","href":"/payments/introduction"}]},{"tab":"Payouts","pages":[{"title":"Payouts","href":"/payouts/payouts/introduction"}]},{"tab":"Secure ID","pages":[{"title":"Secure ID","href":"/secure-id/introduction"}]},{"tab":"Partners and Platforms","pages":[{"title":"Partners and Platforms","href":"/partners/introduction"}]},{"tab":"Payments APIs","hidden":true,"pages":[{"title":"Payments APIs","href":"/api-reference/payments/overview"}]},{"tab":"Payouts APIs","hidden":true,"pages":[{"title":"Payouts APIs","href":"/api-reference/payouts/overview"}]},{"tab":"Secure ID APIs","hidden":true,"pages":[{"title":"Secure ID APIs","href":"/api-reference/vrs/overview"}]},{"tab":"Additional APIs","hidden":true,"pages":[{"title":"Additional APIs","href":"/api-reference/prepaid-payment-instruments/overview"}]},{"tab":"Partners APIs","hidden":true,"pages":[{"title":"Partners APIs","href":"/api-reference/platforms/overview"}]},{"tab":"Additional APIs","hidden":true,"groups":[{"group":"BBPS for Business","pages":[{"title":"BBPS for Business","sidebarTitle":"Overview","description":"API reference for Cashfree BBPS for Business covering NPCI-compliant biller API design, transaction status, complaint handling, and onboarding configuration.","href":"/api-reference/other-apis/bbps/overview"},{"title":"APIs to Implement","sidebarTitle":"APIs to Implement","description":"Reference for the APIs billers must expose to join the BBPS network, covering bill fetch, payment posting, and authentication requirements.","href":"/api-reference/other-apis/bbps/apis-to-implement"},{"title":"Next Steps for Biller","sidebarTitle":"Next Steps for Biller","description":"Follow these next steps after implementing the BBPS biller APIs, including sharing endpoints and credentials with Cashfree to complete onboarding and go live.","href":"/api-reference/other-apis/bbps/next-steps-for-biller"},{"openapi":"get /bbps/biller/bill/status/{bbps_transaction_id}","title":"Check Transaction Status","description":"The check transaction status API allows billers to retrieve the current status of a transaction using the unique BBPS transaction ID associated with the bill. This endpoint serves as a reliable method for querying transaction details, providing merchants with real-time updates on payment status.","href":"/api-reference/other-apis/bbps/check-transaction-status"},{"title":"NPCI Onboarding Configurations","sidebarTitle":"NPCI Onboarding Configurations","description":"Configure BBPS biller onboarding fields including customer input parameters, payment amount exactness, extra bill fetch response data, and acceptance rules.","href":"/api-reference/other-apis/bbps/npci-onboarding-configurations"}]},{"group":"BBPS for Customers","pages":[{"title":"BBPS for Customers","sidebarTitle":"Overview","description":"Cashfree's BBPS COU APIs enable Agent Institutions to connect to the BBPS network and offer bill payment services across all NPCI-registered billers.","href":"/api-reference/other-apis/bbps-cou/overview"},{"title":"Data to Test Integration","sidebarTitle":"Data to Test Integration","description":"Use the sandbox credentials, test billers, and end-to-end flow on this page to validate your BBPS COU integration before going live.","href":"/api-reference/other-apis/bbps-cou/data-to-test-integration"},{"title":"Synchronous Responses","sidebarTitle":"Synchronous responses","description":"Learn how to handle synchronous responses for the Bill Fetch Request and Bill Payment Request APIs when the opt-in feature is enabled.","href":"/api-reference/other-apis/bbps-cou/synchronous-responses"},{"title":"Payment Scenarios","sidebarTitle":"Payment scenarios","description":"BBPS COU payment scenarios for prefunding and postfunding Agent Institutions, covering standard, shortfall, split, and Pay Together use cases.","href":"/api-reference/other-apis/bbps-cou/payment-scenarios"},{"group":"Billers","pages":[{"title":"Fetch Biller Categories","sidebarTitle":"Biller Categories","openapi":"openapi/bbps/bbps-cou.yaml get /bbps/cou/v1/billers/categories","description":"Biller categories represent the top-level classification of billers on the BBPS network, such as Electricity, DTH, Gas, Loan Repayment, and Education Fees. Every biller belongs to a category, and fetching the category list is the first step in the biller discovery flow before initiating a bill fetch or payment.\n\nBecause biller categories change infrequently, cache this response and refresh it periodically rather than calling the API on every user request.","href":"/api-reference/other-apis/bbps-cou/billers/categories"},{"title":"Fetch Biller MDM Details","sidebarTitle":"Biller MDM Details","description":"Retrieve BBPS biller MDM details, including customer parameters, supported payment modes, and fee structures, by biller category or biller ID.","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/info","href":"/api-reference/other-apis/bbps-cou/billers/info"}]},{"group":"Bill Fetch","pages":[{"title":"Bill Fetch Request","sidebarTitle":"Bill Fetch Request","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/request/bill-fetch","href":"/api-reference/other-apis/bbps-cou/bill-fetch/request"},{"title":"Bill Fetch Response","sidebarTitle":"Bill Fetch Response","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/response/bill-fetch","description":"Use this API to retrieve the result of a previously initiated bill fetch or validation request. Pass the `ref_id` returned by the Bill Fetch Request API to get the current status and, on success, the complete bill details or validation confirmation.\n\nThe `flow` field from the Bill Fetch Request response determines what this API returns. For `FETCH_AND_PAY`, the response includes the customer's outstanding bill details for review before payment. For `VALIDATE_AND_PAY`, the response confirms the customer's identity without returning bill details. Use the `message` field to determine whether the result is ready, successful, or failed.\n\n\u003cNote>\nIf synchronous responses are enabled for your account and the Bill Fetch Request API returned HTTP `200`, the final result is already available in `data.result` and you do not need to poll. Poll only when the request returned HTTP `202`.\n\u003c/Note>\n\n\u003cAccordion title=\"Polling strategy\">\n\nPoll at increasing intervals until `message` is no longer `\"Request is still being processed\"`:\n\n| Attempt | Wait before this poll |\n|---|---|\n| 1 | 5 seconds |\n| 2 | 15 seconds |\n| 3 | 30 seconds |\n| 4 | 1 minute |\n| 5+ | 3 minutes |\n\nStop polling when `message` is `\"Bill details fetched successfully\"` or `\"Bill request failed\"`. If the request remains in a processing state beyond your retry limit, treat it as a timeout and raise a support ticket.\n\n\u003c/Accordion>\n\n## API versions\n\nThis API supports two versions through the `x-api-version` header. Version `2026-01-01` introduces the Multi-Bill Fetch and Pay feature, which allows billers to return multiple outstanding bills in a single fetch response. This is useful for billers such as traffic challans or loan accounts where a customer may have more than one outstanding bill.\n\nVersion `2026-01-01` is recommended for all new integrations. In this version, bill details are returned in the `biller_responses` array, which supports both single and multiple bills. In `2025-01-01` (the default), bill details are returned in a single `biller_response` object, which only supports one bill per fetch.\n\n| Header value | Bill details field | Supports multiple bills |\n|---|---|---|\n| `2025-01-01` (default) | `biller_response` (object) | No. Returns only one bill. |\n| `2026-01-01` | `biller_responses` (array) | Yes. Returns all outstanding bills. |\n\nFor billers that support multi-bill fetch and pay (`biller_response_type: LIST` in the Fetch Biller MDM Details response), use `selection_type` from the MDM response to determine whether the customer must pay all bills (`ALL`), can select one (`SINGLE`), or can choose multiple (`MULTIPLE`).\n\n\u003cAccordion title=\"Response fields by flow and outcome\">\n\n| Flow | Outcome | `message` | Fields in `data` |\n|---|---|---|---|\n| Both | Pending | `Request is still being processed` | `bill_fetch_response` |\n| `FETCH_AND_PAY` | Success | `Bill details fetched successfully` | `bill_fetch_response`, `bill_details`, `biller_response` or `biller_responses`, `additional_info` |\n| `VALIDATE_AND_PAY` | Success | `Bill details fetched successfully` | `bill_fetch_response`, `additional_info` |\n| Both | Failed | `Bill request failed` | `bill_fetch_response` (includes `compliance_resp_cd` and `compliance_reason`) |\n\n\u003c/Accordion>\n\n\u003cTip>\nOnce the bill fetch is successful, use the data from this response to initiate payment through the [Bill Payment Request API](/api-reference/other-apis/bbps-cou/bill-payment/request).\n\u003c/Tip>","href":"/api-reference/other-apis/bbps-cou/bill-fetch/response"}]},{"group":"Bill Payment","pages":[{"title":"Bill Payment Request","sidebarTitle":"Bill Payment Request","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/request/bill-payment","description":"Once a bill fetch or validation is successful, use this API to initiate the bill payment. This is the core transaction step in the BBPS bill payment journey. It debits the customer's chosen payment instrument, processes the payment through the BBPS network, and settles the amount with the biller.\n\nPass the `bill_fetch_ref_id` from the Bill Fetch Request to link this payment to the corresponding fetch. For `DIRECT_PAY` billers (where no prior fetch is required), omit the `bill_fetch_ref_id`. Include the bill details, payment method, amount, and payment instrument information as described in the request parameters below.\n\nBy default, this API is asynchronous and returns HTTP `202` with a `transaction_ref_id`. Poll the [Bill Payment Response API](/api-reference/other-apis/bbps-cou/bill-payment/response) using both `bill_fetch_ref_id` and `transaction_ref_id` to get the final payment status. If synchronous responses are enabled for your account, the API attempts to return the final result in the same call. For details, see [Synchronous responses](/api-reference/other-apis/bbps-cou/synchronous-responses).\n\n\u003cWarning>\nWith synchronous responses enabled, handle both HTTP `200` and HTTP `202`, and set your HTTP client timeout to at least 30 seconds. Do not resend a payment request after a client timeout, as this can create a duplicate payment.\n\u003c/Warning>\n\n\u003cTip>\nAfter the payment is processed, use the [Bill Payment Response API](/api-reference/other-apis/bbps-cou/bill-payment/response) to retrieve the final payment status. If the customer has a dispute, use the [Ticket APIs](/api-reference/other-apis/bbps-cou/ticket/request) to raise a support ticket.\n\u003c/Tip>\n\n\u003cNote>\nWhen polling the [Bill Payment Response API](/api-reference/other-apis/bbps-cou/bill-payment/response), use the same `x-api-version` you used for the Bill Fetch Response API. If the biller's `biller_response_type` is `LIST` (from the Fetch Biller MDM Details response), use `x-api-version: 2026-01-01` to receive bill details in the `biller_responses` array. For all other billers, use the default `x-api-version: 2025-01-01`.\n\u003c/Note>","href":"/api-reference/other-apis/bbps-cou/bill-payment/request"},{"title":"Bill Payment Response","sidebarTitle":"Bill Payment Response","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/response/bill-payment","description":"Use this API to retrieve the final status of a previously submitted bill payment. This is the last step in the bill payment journey. A successful response confirms that the payment has been settled with the biller through the BBPS network. For postfunding Agent Institutions, settlement debits the shortfall amount from the shortfall wallet.\n\nPass both `bill_fetch_ref_id` and `transaction_ref_id` from the Bill Payment Request API response. The `bill_fetch_ref_id` is not required for the `DIRECT_PAY` flow. Use the `message` field to determine whether the payment is still processing, successful, or failed.\n\n\u003cNote>\nIf synchronous responses are enabled for your account and the Bill Payment Request API returned HTTP `200`, the final payment status is already available in `data.result` and you do not need to poll. Poll only when the request returned HTTP `202`.\n\u003c/Note>\n\n\u003cAccordion title=\"Polling strategy\">\n\nPoll at increasing intervals until `message` is no longer `\"Payment is still being processed\"`:\n\n| Attempt | Wait before this poll |\n|---|---|\n| 1 | 5 seconds |\n| 2 | 15 seconds |\n| 3 | 30 seconds |\n| 4 | 1 minute |\n| 5+ | 3 minutes |\n\nStop polling when `message` is `\"Payment successful\"` or `\"Payment failed\"`. If the payment remains in a processing state beyond your retry limit, treat it as a timeout and raise a support ticket.\n\n\u003c/Accordion>\n\n\u003cAccordion title=\"Response outcomes\">\n\nThe outcome is conveyed by the top-level `message` and can be confirmed from `data.bill_payment_response.reason.response_code`:\n\n| `message` | `response_code` | Meaning |\n|---|---|---|\n| `Payment is still being processed` | `PENDING` | Payment is still in progress. Continue polling. |\n| `Payment successful` | `000` | Payment completed successfully. Use the response data to show a receipt to the customer. |\n| `Payment failed` | Empty or biller decline code | Payment failed. Read `reason.compliance_reason` for the cause. |\n\n\u003c/Accordion>\n\n## API versions\n\nThis API supports two versions through the `x-api-version` header. Version `2026-01-01` introduces the Multi-Bill Fetch and Pay feature, which allows billers to confirm multiple bills in a single payment response.\n\nVersion `2026-01-01` is recommended for all new integrations. In this version, confirmed bill details are returned in the `biller_responses` array. In `2025-01-01` (the default), bill details are returned in a single `biller_response` object.\n\n| Header value | Bill details field | Supports multiple bills |\n|---|---|---|\n| `2025-01-01` (default) | `biller_response` (object) | No. Returns only one bill. |\n| `2026-01-01` | `biller_responses` (array) | Yes. Returns all settled bills. |\n\nFor billers that support multi-bill fetch and pay (`biller_response_type: LIST` in the Fetch Biller MDM Details response), use `selection_type` from the MDM response to determine how many bills were selected by the customer (`SINGLE`, `MULTIPLE`, or `ALL`).\n\n\u003cTip>\nIf the customer has a dispute about a successfully processed payment, use the [Ticket APIs](/api-reference/other-apis/bbps-cou/ticket/request) to raise a support ticket.\n\u003c/Tip>","href":"/api-reference/other-apis/bbps-cou/bill-payment/response"}]},{"group":"Ticket","pages":[{"title":"Raise a Ticket Request","sidebarTitle":"Ticket Request","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/request/ticket","description":"Use this API to raise a support ticket for a previously processed bill payment.\nThis is an **async** API. It returns an acknowledgement with a `ref_id`.\nPoll the Ticket Status API using `ref_id` to get the current status of your ticket.\n\n\u003cAccordion title=\"Disposition codes\">\n\nPass one of the following codes in the `disposition` field:\n\n| Disposition code | Description | Type |\n|---|---|---|\n| `D11` | Transaction Successful, Amount Debited but services not received | Dispute |\n| `D12` | Transaction Successful, Amount Debited but Service Disconnected or Service Stopped | Dispute |\n| `D13` | Transaction Successful, Amount Debited but LPSC Late Payment Surcharge Charges added in next bill | Dispute |\n| `D21` | Erroneously paid in wrong account | Dispute |\n| `D22` | Duplicate Payment | Dispute |\n| `D23` | Erroneously paid the wrong amount | Dispute |\n| `D31` | Payment information not received from Biller or delay in receiving payment information from the Biller | Complaint |\n| `D32` | Bill paid but amount not adjusted or still showing due amount | Complaint |\n\n\u003c/Accordion>","href":"/api-reference/other-apis/bbps-cou/ticket/request"},{"title":"Poll Ticket Status Response","sidebarTitle":"Ticket Status Response","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/v1/billers/response/ticket-status","description":"Use this API to poll the status of a previously raised ticket.\nCall this using the `ref_id` returned from the Raise Ticket Request API.\n\n\u003cAccordion title=\"Polling strategy\">\n\nPoll at increasing intervals until `message` is no longer `\"Ticket request is still being processed\"`:\n\n| Attempt | Wait before this poll |\n|---|---|\n| 1 | 5 seconds |\n| 2 | 15 seconds |\n| 3 | 30 seconds |\n| 4 | 1 minute |\n| 5+ | 3 minutes |\n\nStop polling when `message` is `\"Ticket details fetched successfully\"` or `\"Ticket request failed\"`. If the ticket remains in a processing state beyond your retry limit, contact Cashfree support with the `ref_id`.\n\n\u003c/Accordion>\n\n\u003cAccordion title=\"Response outcomes by `message`\">\n\n| `message` | Meaning |\n|---|---|\n| `\"Ticket details fetched successfully\"` | Completed. Check `data` for ticket details. |\n| `\"Ticket request failed\"` | Terminal failure. Stop polling. |\n| `\"Ticket request is still being processed\"` | Still processing. Continue polling. |\n\n\u003c/Accordion>","href":"/api-reference/other-apis/bbps-cou/ticket/response"}]},{"group":"Wallet","pages":[{"title":"Fetch Agent Institution Wallet Balance","sidebarTitle":"Wallet Balance","openapi":"openapi/bbps/bbps-cou.yaml get /bbps/cou/agent/{agentId}/wallet/balance","description":"Use this API to fetch the current available wallet balance for a given Agent Institution.\nThis balance reflects funds available for BBPS bill payment transactions.\n\n\u003cNote>\nThe balance can be positive or negative, depending on the Agent Institution's funding model:\n- Prefunding model: the Agent Institution funds the wallet in advance, and bill payments are debited from it. The balance is the remaining prefunded amount and does not go below zero.\n- Shortfall (postfunding) model: bill payments are drawn against the Agent Institution's shortfall wallet. A negative balance represents the current shortfall, that is, the amount the Agent Institution has drawn and must repay.\n\u003c/Note>","href":"/api-reference/other-apis/bbps-cou/wallet/balance"},{"title":"Fetch Agent Institution Wallet Ledger","sidebarTitle":"Wallet Ledger","openapi":"openapi/bbps/bbps-cou.yaml post /bbps/cou/agent/{agentId}/wallet/ledger","description":"Use this API to fetch a paginated list of wallet ledger entries for a given Agent Institution.\nIncludes credits (recharges) and debits (bill payments).\nResults can be filtered by date range, transaction type, or UTR.\nAll request body fields are optional. An empty body returns all entries.\n\n\u003cNote>\nThe ledger lists wallet credits (recharges) and debits (bill payments). On the prefunding model, each bill payment also produces freeze and unfreeze hold entries against the prefunded balance. On the shortfall (postfunding) model, debits can take the running balance negative, reflecting the amount drawn against the credit line.\n\u003c/Note>","href":"/api-reference/other-apis/bbps-cou/wallet/ledger"}]},{"title":"Bill Fetch and Payment Error Codes","sidebarTitle":"Error Codes","description":"Cashfree BBPS Customer Operating Unit (COU) compliance response codes for failed bill fetch, validation, and payment requests, with retry categories.","href":"/api-reference/other-apis/bbps-cou/error-codes"},{"title":"COU Webhooks","sidebarTitle":"COU Webhooks","description":"Cashfree BBPS COU webhooks notify your server when a bill fetch, bill validation, bill payment, or biller MDM update reaches a terminal state.","icon":"webhook","href":"/api-reference/other-apis/bbps-cou/webhooks"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"AI Stack","pages":[{"title":"AI Stack","href":"/tools-ai/overview"}]},{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help/overview"}]}]},"basePath":"","title":"Initiate Bill Fetch | Cashfree","buildId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","deploymentId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-EBSrFTg1.js","utils-Y_7TcRh4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D1wvvkPH.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-aT0ty6oN.js","snippetPresets-DoNRuyJc.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CXRajFpn.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BAyOsINj.js","shallow-CIcHqV1v.js","getApiPlaygroundDisplay-C5igZwEf.js","CodeSnippet-BFWnQLNh.js","CodeSnippets-Cx2mFgZW.js","Page-DCFaZE46.js","getPastedJson-BOy09PZp.js","icon-BwmYtB6R.js","MethodPill-DAIhq-iu.js","DuplicateIcon-DFM8Q3ph.js","createIcon-0UdvzB4Z.js","DynamicMarkdown-DYYZTGpa.js","SectionHeading-BFCDRUuH.js","axios-vUo_bRtp.js","Markdown-C6TcKjiR.js","clsx-Y_UC780V.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-PCbBHBTv.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D4q_oRML.js"]}