# 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. Concentrator has a Client ID associated with the MTF certificate that was approved in the previous condition assigned and active on their 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 in inbound call made by the concentrator 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 of the optional data that you wish to provide 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**            | The Biller is successfully added to Bill Pay                                                                                                                                                                                                                                                                                                                                                                             |
| **Notes**                      | After successful completion of this scenario, the a work request for the Biller will have been created in Bill Pay. Please 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 will use a billerId that already exists on the Bill Pay system to simulate the error that would return.                                                                                                                                                                                                                                                                                                                                                 |
| **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 of the optional data that you wish to provide that is relevant for the 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**            | Service Error Code: BPBMSAPI_ERR_0007 is generated in the Response Message                                                                                                                                                                                                                                                                                                                                                                                           |
| **Notes**                      | After receiving the error, share the logs from the response with CIS.                                                                                                                                                                                                                                                                                                                                                                                                |

<br />

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

|                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Test Title**           | Add a Biller with a multiple RPPSBillerAddress.                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Description**          | Concentrator will submit 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 of the optional data that you wish to provide that is relevant for the 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**      | A successful response will create a work order.                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Notes**                | After successfully submitting the Biller, inform CIS that you have simulated multiple RPPSBillerAddress. Please 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 a RPPSBillerAddress.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Description**                | Concentrator will submit a 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 of the optional data that you wish to provide that is relevant for the 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**            | A successful response will create a work order.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Notes**                      | After successfully submitting the Biller, inform CIS that you have 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 a multiple RPPSBillerMask.                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Description**          | Concentrator will submit 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 of the optional data that you wish to provide that is relevant for the 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**      | A successful response will create a work order.                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Notes**                | After successfully submitting the Biller, inform CIS that you have simulated multiple RPPSBillerMask. Please 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 a multiple RPPSBillerAkas.                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Description**          | Concentrator will submit 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, RPPSBillerAkas, RPPSBillerAkas.* **Step 2:** Include any of the optional data that you wish to provide that is relevant for the 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**      | A successful response will create a work order.                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Notes**                | After successfully submitting the Biller, inform CIS that you have simulated multiple RPPSBillerAkas. Please 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 will submit 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 of the optional data that you wish to provide that is relevant for the 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**            | Service Error Code: BPBMSAPI_ERR_0003 is generated in the Response Message                                                                                                                                                                                                                                                                                                                                                                                               |
| **Notes**                      | After receiving the error, share the logs from the response 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 will submit a Biller that has an effectiveDate that is less than 5 business days, greater than 7 business days 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 of the optional data that you wish to provide that is relevant for the Biller. **Step 3:** Pick an invalid date (Less than 5 business days, greater than 7 business days 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**            | Service Error Code: Depending on the scenario one of the following errors will be generated: BPBMSAPI_ERR_0009, BPBMSAPI_ERR_0010, BPBMSAPI_ERR_0011 is generated in the Response Message                                                                                                                                                                                                                                                                                                                                                      |
| **Notes**                      | After receiving the error, share the logs from the response with CIS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

<br />