---
updatedAt: 2026-06-18T21:55:14.000Z
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# BILL Network

The BILL Network is a collection of vendor organizations and customer organizations using BILL. BILL automatically enables electronic payments between connected vendors and customers. In addition, connected vendors receive payments in their set payment method - ACH, virtual card, or even check.

<Cards>
  <Card title="Verified national vendors">
    Verified national vendors (Large billers) include water, power, cable, and phone companies and are part of the BILL verified national vendor network.

    The BILL Network includes the verified national vendor network.
  </Card>

  <Card title="Over 7 million entities">
    With over 7 million entities in the BILL Network, send fast, secure ePayments, simplify vendor onboarding, and automatically reconcile payments.

    The result is saved time and reduction in manual work.
  </Card>
</Cards>

## Vendor types

BILL has 2 types of vendors.

<Image align="center" caption="Vendor record workflow" src="https://files.readme.io/856ea815f79d247feb19080c62b6842fd23c1b0594619fa6cc36c152278d8856-Blank_diagram_-_Page_9_1.png" />

### Private vendors

A private vendor is a record not connected to the BILL Network. You manually manage the vendor details.

| Payment type       | Description                                                                                                                                                                                                                                                                                                                                 |
| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Check vendor       | Provide an address; BILL mails a paper check.                                                                                                                                                                                                                                                                                               |
| Private ACH vendor | Provide bank details; BILL sends electronic payments.                                                                                                                                                                                                                                                                                       |
| Virtual card       | If a private vendor accepts virtual cards, BILL automatically updates the payment method to `VIRTUAL CARD` with the auto-enrollment process. See <Anchor label="BILL terminology" target="_blank" href="https://developer.bill.com/update/docs/bill-terminology">BILL terminology</Anchor> to learn more about the auto-enrollment process. |

### Public vendors (or BILL Network vendors)

Public vendors are entities already established in the BILL Network.

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Vendor type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        BILL AR organization (Advanced Receivables)
      </td>

      <td>
        These are organizations or individuals that subscribe to BILL directly or through a partner for the BILL Advanced Receivables account.

        These organizations must accept an invite before they are **`CONNECTED`** in the BILL Network and can be paid electronically.
      </td>
    </tr>

    <tr>
      <td>
        BILL BR organization (Basic Receivables)
      </td>

      <td>
        These are organizations that join the BILL Network for free with an invite from a BILL subscriber and create a Basic Receivables account to manage their payment information.

        These organizations are not required to accept an invite before they are  **`CONNECTED`** in the BILL Network to be paid electronically.
      </td>
    </tr>

    <tr>
      <td>
        Verified national vendors (RPPS)
      </td>

      <td>
        This directory includes large billers, such as national or regional telecommunications companies, utility companies, banks, and large retailers. These vendors always require an account number (and occasionally a zip code) to connect and pay. No acceptance is required for connection. Provided the account number and, if required, zip code pass validation, the payer connects for electronic payments.
      </td>
    </tr>
  </tbody>
</Table>

## BILL Network connections

### Connect in the Network

You can convert a private vendor to a public vendor in 3 ways.

| Method            | Description                                                                                                                                                                                   |
| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Auto-connect      | BILL automatically matches private vendor details with vendors in the BILL Network. When BILL finds a confident match, BILL updates the vendor details to the public profile.                 |
| Manual search     | Use the BILL v3 API or BILL Elements to search for the vendor in the BILL Network with information about the private vendor. If you find a match (RPPS, AR, or BR), you can connect manually. |
| Vendor invitation | Invite a private vendor to create a Basic Receivables (BR) account. When the vendor accepts the invite, they become a public vendor.                                                          |

### Disconnect from the Network

If you connected with the incorrect vendor in the BILL Network or if you want to manage payment preferences manually, you can disconnect from the public vendor.

#### Prerequisites

Before you disconnect from a public vendor, ensure that no payments are currently processing or scheduled. You must wait for the payments to complete or void before you can disconnect from the public vendor.

In addition, confirm the vendor mailing address before disconnection to ensure that BILL delivers checks to the correct vendor address location.

## BILL Network implementation guidelines

This section details how to build a vendor management experience based on vendor Network status.

<Image align="center" caption="Vendor state lifecycle" src="https://files.readme.io/d772a6293d159ac2deb8cf11be4132ed409d59d379b572e643c0a86161d98cc2-vendorstatelifecycle.png" />

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Status
      </th>

      <th>
        Scenario
      </th>

      <th>
        Vendor management in your system
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **`NOT CONNECTED`**
      </td>

      <td>
        Private vendor
      </td>

      <td>
        Enable users to edit vendor details, and ensure that you sync all updates with BILL.
      </td>
    </tr>

    <tr>
      <td>
        **`PENDING`**
      </td>

      <td>
        The vendor is invited to connect in the BILL Network, but has not yet accepted.
      </td>

      <td>
        **Identity storage**: Each time a vendor is created in a BILL organization, capture and store vendor data (with the BILL v3 API or BILL Elements).

        **Enable editing**: Enable users to edit vendor details, and ensure that you sync all updates with BILL.

        **Manage invites**

        * **Cancel**: Enable users to cancel BILL Network invitations.
        * **Remind**: Enable users to send reminder emails to the vendor.
      </td>
    </tr>

    <tr>
      <td>
        **`CONNECTED`**
      </td>

      <td>
        Public vendor (or BILL Network vendor)
      </td>

      <td>
        **Identity storage**: Each time a vendor is created in a BILL organization, capture and store vendor data (with the BILL v3 API or BILL Elements).

        **Disable editing**: Disable vendor detail updates. Display a **Managed by BILL** status to prevent data conflicts.

        **Manage connections**

        * **Disconnect**: Enable users to disconnect from a public vendor. This action unlocks the vendor record for manual vendor details management.
        * **Validate address**: Display the vendor mailing address during payment creation. This enables users to ensure that BILL delivers checks to the correct vendor address location.
      </td>
    </tr>
  </tbody>
</Table>

## Documentation resources

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Section
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Vendor setup
      </td>

      <td>
        **API**: <Anchor label="Create a vendor" target="_blank" href="https://developer.bill.com/reference/createvendor">Create a vendor</Anchor> with `POST /v3/vendors`  
        **Element**: <Anchor label="Vendor setup Element" target="_blank" href="https://developer.bill.com/docs/vendor-setup-element">Vendor setup Element</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        Vendor management
      </td>

      <td>
        **API**

        * <Anchor label="Get list of vendors" target="_blank" href="https://developer.bill.com/reference/listvendors">Get list of vendors</Anchor> with `GET /v3/vendors`
        * <Anchor label="Get vendor details" target="_blank" href="https://developer.bill.com/reference/getvendor">Get vendor details</Anchor> with `GET /v3/vendors/{vendorId}`
        * <Anchor label="Update a vendor" target="_blank" href="https://developer.bill.com/reference/updatevendor">Update a vendor</Anchor> with `PATCH /v3/vendors/{vendorId}`
        * <Anchor label="Archive a vendor" target="_blank" href="https://developer.bill.com/reference/archivevendor">Archive a vendor</Anchor> with `POST /v3/vendors/{vendorId}/archive`
        * <Anchor label="Restore an archived vendor" target="_blank" href="https://developer.bill.com/reference/restorevendor">Restore an archived vendor</Anchor> with `POST /v3/vendors/{vendorId}/restore`

        **Element**: <Anchor label="Vendor setup Element" target="_blank" href="https://developer.bill.com/docs/vendor-setup-element">Vendor setup Element</Anchor>
      </td>
    </tr>

    <tr>
      <td>
        More details
      </td>

      <td>
        **Guides**: <Anchor label="BILL Network" target="_blank" href="https://developer.bill.com/docs/bill-network">BILL Network</Anchor>  
        **API**: <Anchor label="/v3/network" target="_blank" href="https://developer.bill.com/reference/search">/v3/network</Anchor>
      </td>
    </tr>
  </tbody>
</Table>

<br />