This guide explains how to use the billpay-related endpoints. For additional billpay information, see these guides:
<a href="doc:about-bill-pay" target="_blank">**About Bill Pay**</a> — General information about bill pay at Galileo
<a href="doc:creating-a-billpay-transaction" target="_blank">**Creating a Billpay Transaction**</a> — Instructions for creating billpay transactions, including adding billers and creating scheduled transactions
<a href="doc:managing-billpay-transactions" target="_blank">**Managing Billpay Transactions**</a> — Instructions for displaying and canceling billpay transactions and removing billers.
## Search Biller Directory
Consult the <a href="doc:creating-a-billpay-transaction#adding-a-biller" target="_blank">Adding a biller</a> section of the _Creating a Billpay Transaction_ guide to see where this endpoint fits in the sequence of events.
This table explains the parameters that are specific to the Search Biller Directory endpoint. See the <a href="ref:post_searchbillerdirectory" target="_blank">Search Biller Directory</a> reference for details.
| Parameter | Usage |
`billerAccountNo` | _Optional._ When this parameter is passed, the search engine compares it to biller-supplied masks, and an account number that matches a mask will help narrow the search. |
`billerName` | Pass a complete or partial name of a biller to begin the search. In some cases, a single term will return multiple entries, and the account holder must select from among them. Alternatively, you can pass `billerState` and/or `billerAccountNo` to filter the results. |
`billerState` | _Optional._ When this parameter is passed, the search is narrowed to billers with addresses in that state or province. Galileo recommends passing this parameter to help distinguish between billers with the same name. |
In the response, the `biller_account_no_patterns` may include one or more masks that you can use to validate the `billerAccountNo` for the Add RPPS Biller endpoint.
## Add RPPS Biller
Consult the <a href="doc:creating-a-billpay-transaction#adding-a-biller" target="_blank">Adding a biller</a> section of the _Creating a Billpay Transaction_ guide to see where this endpoint fits in the sequence of events.
This table explains the parameters that are specific to the Add RPPS Biller endpoint. See the <a href="ref:post_addrppsbiller" target="_blank">Add RPPS Biller</a> reference for details.
| Parameter | Usage |
`rppsBillerId` | This is the `rpps_biller_id` as returned by <a href="ref:post_searchbillerdirectory" target="_blank">Search Biller Directory</a>, if the biller is present in the directory. If it is not, use the <a href="ref:post_addpaperbiller" target="_blank">Add Paper Biller</a> endpoint to add the biller. |
`billerAccountNo` | This is the account number that the account holder has with the biller. The response to <a href="ref:post_searchbillerdirectory" target="_blank">Search Biller Directory</a> contains `biller_account_no_patterns`, which indicate how an account number must be formatted for that biller. The endpoint validates the account number in this parameter against those masks. If the number does not match the pattern, the endpoint returns `status code: 485-03`.<br><br>This value cannot be updated with <a href="ref:post_modifyrppsbiller" target="_blank">Modify RPPS Biller</a>; if the account holder submits an incorrect `billerAccountNo` that is accepted by the endpoint, you must remove the biller and create the biller again with the correct `billerAccountNo`. |
| Scheduling parameters | _Optional._ Leave these blank to add a biller without setting up scheduled payments, or see <a href="doc:creating-a-billpay-transaction#scheduling-billpay-transactions" target="_blank">Scheduling billpay transactions</a> in the _Creating a Billpay Transaction_ guide for instructions on setting up a schedule. |
## Modify RPPS Biller
The only properties of an RPPS biller that you can modify are the schedule and the amount of recurring payments. If you need to change the biller account number, you must remove the biller and replace it with a new biller.
This table explains the parameters that are specific to the Modify RPPS Biller endpoint. See the <a href="ref:post_modifyrppsbiller" target="_blank">Modify RPPS Biller</a> reference for details.
| Parameter | Usage |
`billerId` | This is the `biller_id` from <a href="ref:post_addrppsbiller" target="_blank">Add RPPS Biller</a> or <a href="doc:post_getbillers" target="_blank">Get Billers</a>. Do not use the `rpps_biller_id` from Search Biller Directory. |
| Scheduling parameters | See <a href="doc:creating-a-billpay-transaction#scheduling-billpay-transactions" target="_blank">Scheduling billpay transactions</a> in the _Creating a Billpay Transaction_ guide for instructions on using these parameters. These parameters can be nullified. |
## Add Paper Biller
Consult the <a href="doc:creating-a-billpay-transaction#adding-a-biller" target="_blank">Adding a biller</a> section of the _Creating a Billpay Transaction_ guide to see where this endpoint fits in the sequence of events.
This table explains the parameters that are specific to the Add Paper Biller endpoint. See the <a href="ref:post_addpaperbiller" target="_blank">Add Paper Biller</a> reference for details. These values are not validated.
| Parameter | Usage |
`billerName` | Display name, provided by the account holder. This value does not need to be unique—you can create multiple paper billers with this name as long as the addresses are different. |
| Address parameters | Mailing address for the biller. |
`billerPhone` | _Optional._ Phone number for the biller. |
`billerAccountNo` | This is the account number that the account holder has with the biller. This value is not validated against a formatting mask.<br><br>This value cannot be edited with <a href="ref:post_modifypaperbiller" target="_blank">Modify Paper Biller</a>; if the account holder submits an incorrect `billerAccountNo`, you must remove the biller and create the biller again with the correct `billerAccountNo`.<br><br>You can also pass `NA` or another string when the check recipient is an individual or a business that doesn't maintain accounts for its clients. |
| Scheduling parameters | _Optional._ Leave these blank to add a biller without setting up scheduled payments, or see <a href="doc:creating-a-billpay-transaction#scheduling-billpay-transactions" target="_blank">Scheduling billpay transactions</a> in the _Creating a Billpay Transaction_ guide for instructions on setting up a schedule. |
## Modify Paper Biller
The only properties of a paper biller that you can modify are the biller address and phone, schedule, and the amount of recurring payments. If you need to change the biller account number, you must remove the biller and replace it with a new biller.
This table explains the parameters that are specific to the Modify Paper Biller endpoint. See the <a href="ref:post_modifypaperbiller" target="_blank">Modify Paper Biller</a> reference for details.
| Parameter | Usage |
`billerId` | This is the `biller_id` from <a href="ref:post_addpaperbiller" target="_blank">Add Paper Biller</a> or <a href="doc:post_getbillers" target="_blank">Get Billers</a>. |
| Address parameters | To update any of the address parameters, you must pass all of the address parameters. |
`billerPhone` | Update or nullify |
| Scheduling parameters | See <a href="doc:creating-a-billpay-transaction#scheduling-billpay-transactions" target="_blank">Scheduling billpay transactions</a> in the _Creating a Billpay Transaction_ guide for instructions on using these parameters. These parameters can be nullified. |
## Create Bill Payment
Use this endpoint to create a one-time bill payment for a biller that has already been added to the account. Consult <a href="ref:creating-a-billpay-transaction#creating-a-one-time-billpay-transaction" target="_blank">Creating a one-time billpay transaction</a> in the _Creating a Billpay Transaction_ guide to see where this endpoint fits in the sequence of events.
This table explains the parameters that are specific to the Create Bill Payment endpoint. See the <a href="ref:post_createbillpayment" target="_blank">Create Bill Payment</a> reference for details.
| Parameter | Usage |
`billerId` | This is the `biller_id` from <a href="ref:post_addrppsbiller" target="_blank">Add RPPS Biller</a>, <a href="ref:post_addpaperbiller" target="_blank">Add Paper Biller</a> or <a href="doc:post_getbillers" target="_blank">Get Billers</a>. Do not use the `rpps_biller_id` from Search Biller Directory. |
`processDate` | _Optional._ Input a date in the future, or leave blank for the transaction to be processed on the current date. |
`memo` | _Optional._ This message will be <a href="doc:creating-a-billpay-transaction#example-paper-check" target="_blank">printed on the check</a> in the **Memo** field. |