{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-vas/vas.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Biller list","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"biller-list"},"children":["Biller list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Biller list calls are optional API calls that return a list of the available billers to the originating system. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listBillers"]}," operation should be performed daily to ensure that the originating system's biller information is always up to date."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can easily configure the biller list directly from Electrum Console, allowing you to specify which billers are allowed or not allowed. This integration seamlessly connects with your internal system to determine the billers shown to your customers. Additionally, if new billers are added to the Service Providers, you can manage these services without extra cost using the Electrum front-end."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The list of billers returned to you is based on Electrum's biller catalogue system. Electrum allows for you to manage a biller catalogue via our system. This would let you manage billers from your side and immediately load the catalogue into the Electrum system."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Implementation of biller list API calls is optional."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operation-and-messages"},"children":["Operation and Messages"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A biller list call consists of a single set of messages described by the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/listbillers"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listBillers"]}]}," operation, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET/billers"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/billerlistresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BillerListResponse"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Error payload: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more detail, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger"},"children":["Account Payments Service Interface"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"message-flows"},"children":["Message Flows"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"successful-biller-list-transaction"},"children":["Successful Biller List Transaction"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/billers"]}," API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/listbillers"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listBillers"]}]},"  operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API responds with a list of the billers in a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/billerlistresponse"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BillerListResponse"]}]}," message payload."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/successful-list-billers.72eae32c7a96f754ce14b174fa48fa83f02892a4bff7a0e818511ce15ddcbe44.45baa1d1.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-or-timeout-at-originating-system"},"children":["Error or Timeout at Originating System"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a GET call to the /billers API endpoint (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/listbillers"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listBillers"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An error occurs at the originating system or a timeout occurs when the originating system does not receive a response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The transaction is considered failed and no further messaging is required, however, the originating system can attempt the transaction again."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend that the originating system attempts the transaction again until a successful response is obtained. This will ensure that the originating system has the correct biller information."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/error-at-os-during-list-billers.ac3f698f9261ffbb7e506eb380c92feef93cec779c89a464c9c22c88647cb1d6.45baa1d1.png","alt":"alt text"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-at-service-provider"},"children":["Error at Service Provider"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The originating system sends a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/billers"]}," API endpoint ."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An error occurs at Electrum or the service provider (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/other/listbillers"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listBillers"]}]}," operation)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Electrum sends an HTTP status of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["501"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["503"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["504"]}," and an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.electrumsoftware.com/openapi/billpay/swagger/schema/errordetail"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorDetail"]}]}," message payload to the originating system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No further messaging is required, however, the originating system can attempt the transaction again."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend that the originating system attempts the transaction again until a successful response is obtained. This will ensure that the originating system has the correct biller information."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/error-at-electrum-during-list-billers.27be0af8c97adb173059d6d38c66d4d14fb6bb1d7163b25a4e93a661bd228934.45baa1d1.png","alt":"alt text"},"children":[]}]}]},"headings":[{"value":"Biller list","id":"biller-list","depth":1},{"value":"Operation and Messages","id":"operation-and-messages","depth":2},{"value":"Message Flows","id":"message-flows","depth":2},{"value":"Successful Biller List Transaction","id":"successful-biller-list-transaction","depth":2},{"value":"Error or Timeout at Originating System","id":"error-or-timeout-at-originating-system","depth":2},{"value":"Error at Service Provider","id":"error-at-service-provider","depth":2}],"frontmatter":{"seo":{"title":"Biller list"}},"lastModified":"2026-01-28T10:41:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/vas/public/bill-payments/integrate-your-channel/biller-list","userData":{"isAuthenticated":false,"teams":["anonymous"]}}