# Add Biller
source: https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/testing/add-biller-tests/index.md

## Test Suite 1.0 RPPS Biller Maintenance Service {#test-suite-10-rpps-biller-maintenance-service}

|                              |                                                                                                                                                                                                                                                                                                |
|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Suite Name**          | Biller Add                                                                                                                                                                                                                                                                                     |
| **MTF Inbound API Endpoint** | `https://api.mastercard.com/billpay/mtf/biller-maintenance/biller-request`                                                                                                                                                                                                                     |
| **Pre-Conditions**           | Concentrator has successfully been onboarded to the MTF environment. Concentrator has successfully requested and received approval for an MTF certificate. The Client ID associated with the approved MTF certificate is assigned and active on the Concentrator's API Key Management profile. |
| **Post-Condition**           | Concentrator has successfully completed all the Test Cases.                                                                                                                                                                                                                                    |
| **Dependencies**             | Data to support the scenarios is correctly configured by Mastercard to simulate the Test Cases.                                                                                                                                                                                                |
| **Overall Test Notes**       | The Biller Add service is an inbound call that the Concentrator makes to add a Biller in Bill Pay.                                                                                                                                                                                             |

## Test Cases {#test-cases}

### Test Case: Add Biller - Success {#test-case-add-biller---success}

|                                |                                                                                                                                                                                                                                                                                                                                                                                          |
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**                 | Successfully add a Biller                                                                                                                                                                                                                                                                                                                                                                |
| **Description**                | Concentrator successfully adds a Biller to the Bill Pay system.                                                                                                                                                                                                                                                                                                                          |
| **Pre-Requisite**              | Concentrator has all the required information to add a new Biller to Bill Pay.                                                                                                                                                                                                                                                                                                           |
| **Test Steps to add a Biller** | **Step 1:** Complete the mandatory and conditional fields for these schemas: *Biller, RPPSBillerBillerInfo, RPPSBillerAddress, RPPSBillerMask, RPPSBillerAkas.* **Step 2:** Include any optional data that is relevant to your Biller. [Review Add Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md) |
| **Expected Result**            | HTTP 200 with `statusIndicator` set to `SUCCESS` and a `workRequestId`. A work request is created to add the Biller to Bill Pay.                                                                                                                                                                                                                                                         |
| **Notes**                      | After this scenario completes successfully, a work request for the Biller exists in Bill Pay. Provide the billerId and workRequestId to CIS.                                                                                                                                                                                                                                             |

<br />

### Test Case: Add Biller - billerId Match {#test-case-add-biller---billerid-match}

|                                |                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**                 | Attempt to add a Biller with a billerId that already exists.                                                                                                                                                                                                                                                                                                                                                                         |
| **Description**                | Concentrator uses a billerId that already exists in Bill Pay to trigger the duplicate Biller ID error.                                                                                                                                                                                                                                                                                                                               |
| **Pre-Requisite**              | billerId already exists in Bill Pay.                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Test Steps to create error** | **Step 1:** Complete the mandatory and conditional fields for these schemas: *Biller, RPPSBillerBillerInfo, RPPSBillerAddress, RPPSBillerMask, RPPSBillerAkas.* **Step 2:** Include any optional data that is relevant to your Biller. **Step 3:** Use billerId ***7495578307*** . [Review Add Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md) |
| **Expected Result**            | HTTP 400 with service error code BPBMSAPI_ERR_0007 in the response.                                                                                                                                                                                                                                                                                                                                                                  |
| **Notes**                      | After you receive the error, share the response logs with CIS.                                                                                                                                                                                                                                                                                                                                                                       |

<br />

### Test Case: Add Biller - multiple RPPSBillerAddress {#test-case-add-biller---multiple-rppsbilleraddress}

|                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**           | Add a Biller with multiple RPPSBillerAddress records.                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Description**          | Concentrator submits more than one RPPSBillerAddress successfully.                                                                                                                                                                                                                                                                                                                                                                                        |
| **Pre-Requisite**        | Concentrator has all the required information to add a new Biller to Bill Pay.                                                                                                                                                                                                                                                                                                                                                                            |
| **Test Steps to create** | **Step 1:** Complete the mandatory and conditional fields for these schemas: *Biller, RPPSBillerBillerInfo, RPPSBillerAddress, RPPSBillerMask, RPPSBillerAkas.* **Step 2:** Include any optional data that is relevant to your Biller. **Step 3:** Ensure that more than one RPPSBillerAddress is used. [Review Add Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md) |
| **Expected Result**      | HTTP 200 with `statusIndicator` set to `SUCCESS`. A work request is created.                                                                                                                                                                                                                                                                                                                                                                              |
| **Notes**                | After you submit the Biller, tell CIS that you simulated multiple RPPSBillerAddress. Provide the billerId and workRequestId to CIS.                                                                                                                                                                                                                                                                                                                       |

<br />

### Test Case: Add Biller - billerName and RPPSBillerAddress Match {#test-case-add-biller----billername-and-rppsbilleraddress-match}

|                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**                 | Add a Biller that matches an existing RPPSBillerAddress.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Description**                | Concentrator submits an RPPSBillerAddress that matches another Biller's RPPSBillerAddress.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Pre-Requisite**              | RPPSBillerAddress already exists in Bill Pay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Test Steps to create match** | **Step 1:** Complete the mandatory and conditional fields for these schemas: *Biller, RPPSBillerBillerInfo, RPPSBillerMask, RPPSBillerAkas.* **Step 2:** Include any optional data that is relevant to your Biller. **Step 3:** Use the following details: -billerName: ***1-800-Flowers*** RPPSBillerAddress:\* - type: ***'Sta'*** - address1: ***'PO Box 105658'*** - city: ***'Atlanta'*** - state: ***'GA'*** - postalCode: ***'30348-5658'*** [Review Add Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md) |
| **Expected Result**            | HTTP 200 with `statusIndicator` set to `SUCCESS`. A work request is created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Notes**                      | After you submit the Biller, tell CIS that you simulated a matching RPPSBillerAddress, and provide the billerId and workRequestId.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

<br />

### Test Case: Add Biller - multiple RPPSBillerMask {#test-case-add-biller---multiple-rppsbillermask}

|                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**           | Add a Biller with multiple RPPSBillerMask records.                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Description**          | Concentrator submits more than one RPPSBillerMask successfully.                                                                                                                                                                                                                                                                                                                                                                                        |
| **Pre-Requisite**        | Concentrator has all the required information to add a new Biller to Bill Pay.                                                                                                                                                                                                                                                                                                                                                                         |
| **Test Steps to create** | **Step 1:** Complete the mandatory and conditional fields for these schemas: *Biller, RPPSBillerBillerInfo, RPPSBillerAddress, RPPSBillerMask, RPPSBillerAkas.* **Step 2:** Include any optional data that is relevant to your Biller. **Step 3:** Ensure that more than one RPPSBillerMask is used. [Review Add Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md) |
| **Expected Result**      | HTTP 200 with `statusIndicator` set to `SUCCESS`. A work request is created.                                                                                                                                                                                                                                                                                                                                                                           |
| **Notes**                | After you submit the Biller, tell CIS that you simulated multiple RPPSBillerMask. Provide the billerId and workRequestId to CIS.                                                                                                                                                                                                                                                                                                                       |

<br />

### Test Case: Add Biller - multiple RPPSBillerAkas {#test-case-add-biller---multiple-rppsbillerakas}

|                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**           | Add a Biller with multiple RPPSBillerAkas records.                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Description**          | Concentrator submits more than one RPPSBillerAkas successfully.                                                                                                                                                                                                                                                                                                                                                                                        |
| **Pre-Requisite**        | Concentrator has all the required information to add a new Biller to Bill Pay.                                                                                                                                                                                                                                                                                                                                                                         |
| **Test Steps to create** | **Step 1:** Complete the mandatory and conditional fields for these schemas: *Biller, RPPSBillerBillerInfo, RPPSBillerAddress, RPPSBillerMask, RPPSBillerAkas.* **Step 2:** Include any optional data that is relevant to your Biller. **Step 3:** Ensure that more than one RPPSBillerAkas is used. [Review Add Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md) |
| **Expected Result**      | HTTP 200 with `statusIndicator` set to `SUCCESS`. A work request is created.                                                                                                                                                                                                                                                                                                                                                                           |
| **Notes**                | After you submit the Biller, tell CIS that you simulated multiple RPPSBillerAkas. Provide the billerId and workRequestId to CIS.                                                                                                                                                                                                                                                                                                                       |

<br />

### Test Case: Add Biller - Invalid state {#test-case-add-biller----invalid-state}

|                                |                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**                 | Add a Biller with an invalid state.                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Description**                | Concentrator submits a Biller that has an invalid state.                                                                                                                                                                                                                                                                                                                                                                                 |
| **Pre-Requisite**              | Concentrator has all the required information to add a new Biller to Bill Pay.                                                                                                                                                                                                                                                                                                                                                           |
| **Test Steps to create error** | **Step 1:** Complete the mandatory and conditional fields for these schemas: *Biller, RPPSBillerBillerInfo, RPPSBillerAddress, RPPSBillerMask, RPPSBillerAkas.* **Step 2:** Include any optional data that is relevant to your Biller. **Step 3:** Submit an invalid state: ***'ZZ'*** [Review Add Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md) |
| **Expected Result**            | HTTP 400 with service error code BPBMSAPI_ERR_0003 in the response.                                                                                                                                                                                                                                                                                                                                                                      |
| **Notes**                      | After you receive the error, share the response logs with CIS.                                                                                                                                                                                                                                                                                                                                                                           |
|                                |                                                                                                                                                                                                                                                                                                                                                                                                                                          |

### Test Case: Add Biller - Invalid effectiveDate {#test-case-add-biller----invalid-effectivedate}

|                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**                 | Add a Biller with an invalid effectiveDate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Description**                | Concentrator submits a Biller with an effectiveDate that is less than 5 business days away, more than 7 business days away, or on a weekend.                                                                                                                                                                                                                                                                                                                                                                           |
| **Pre-Requisite**              | Concentrator has all the required information to add a new Biller to Bill Pay.                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Test Steps to create error** | **Step 1:** Complete the mandatory and conditional fields for these schemas: *Biller, RPPSBillerBillerInfo, RPPSBillerAddress, RPPSBillerMask, RPPSBillerAkas.* **Step 2:** Include any optional data that is relevant to your Biller. **Step 3:** Pick an invalid date: less than 5 business days away, more than 7 business days away, or on a Saturday or Sunday. [Review Add Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md) |
| **Expected Result**            | HTTP 400 with one of the following service error codes, depending on the scenario: BPBMSAPI_ERR_0010 (less than 5 business days), BPBMSAPI_ERR_0009 (more than 7 business days), or BPBMSAPI_ERR_0008 (weekend or holiday).                                                                                                                                                                                                                                                                                            |
| **Notes**                      | After you receive the error, share the response logs with CIS.                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

<br />

## Next Steps {#next-steps}

* [Quick Start Guide](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/getting-started/index.md) --- get credentials and make your first call
* [API Reference](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/api-reference/index.md) --- full OpenAPI specification
* [Testing](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/testing/index.md): test environments, methods, and troubleshooting.