# Code and Formats
source: https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md

This section describes errors that the Mastercard gateway or the Remote Payment and Presentment Service (RPPS) Biller Maintenance Service can return.

The error format depends on which component generated the error and at what point the request failed:

1. Application error messages are returned by the service and typically occur because of incorrect input.
2. Gateway error codes are returned by the gateway and typically occur when OAuth 1.0a authentication fails.

For exact field formats, lengths, and allowed values, see the [API Reference](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/api-reference/index.md).

### Where Errors Occur {#where-errors-occur}

|                    Endpoint                    |               Workflow step               |                                   Typical reason codes                                    |
|------------------------------------------------|-------------------------------------------|-------------------------------------------------------------------------------------------|
| POST `/biller-request`                         | Adding, editing, or deactivating a Biller | `BPBMSAPI_ERR_0002` to `BPBMSAPI_ERR_0074` and `BPBMSAPI_ERR_0077` to `BPBMSAPI_ERR_0119` |
| GET `/biller/{biller_id}`                      | Retrieving Biller details before an edit  | `BPBMSAPI_ERR_0021` (invalid Biller ID) and `BPBMSAPI_ERR_0072` (no access)               |
| GET `/biller-request/{work_request_id}/status` | Checking work request status              | `BPBMSAPI_ERR_0075` (invalid work request ID) and `BPBMSAPI_ERR_0076` (no access)         |

Access errors (`BPBMSAPI_ERR_0071`, `BPBMSAPI_ERR_0072`, and `BPBMSAPI_ERR_0076`) return HTTP `403` and are not recoverable by changing the request. All other service errors return HTTP `400`. Correct the request as described in **How to Resolve** and resubmit it.

### Error Structure {#error-structure}

Mastercard returns errors in the following structure.

```json
{
  "Errors": {
    "Error": [
      {
        "Source": "<source>",
        "ReasonCode": "<unique code>",
        "Description": "<short description of the error>",
        "Recoverable": true/false,
        "Details": "<Optional detailed description of the issue>"
      }
    ]
  }
}
```

## HTTP Response and Reason Codes {#http-response-and-reason-codes}

### Service Error Codes {#service-error-codes}

The **Description** column shows the message text that the service returns in the `Details` field.

| **Error/Reason Code** | **HTTP Code** |                                                                                                               **Description**                                                                                                               |                                                                                                  **How to Resolve**                                                                                                  |
|-----------------------|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| BPBMSAPI_ERR_0000     | 400           | Internal Server Error, please contact support for help                                                                                                                                                                                      | Contact Support                                                                                                                                                                                                      |
| BPBMSAPI_ERR_0001     | 400           | No Request Mapping found                                                                                                                                                                                                                    | Contact Support                                                                                                                                                                                                      |
| BPBMSAPI_ERR_0002     | 400           | Biller remittance type code value invalid, must be 'Sta' or 'Pre'                                                                                                                                                                           | Update biller remittance type code with 'Sta' or 'Pre'                                                                                                                                                               |
| BPBMSAPI_ERR_0003     | 400           | State Code value is invalid, must be a valid value from the API YAML                                                                                                                                                                        | Update state code with a valid 2 character state code listed in the YAML file                                                                                                                                        |
| BPBMSAPI_ERR_0004     | 400           | File Format for the specified Concentrator RPPSID is invalid, must be 'MOD-CIE'                                                                                                                                                             | Update file format to 'MOD-CIE'. If a biller is not associated with MOD-CIE format, the biller cannot be added through the API service.                                                                              |
| BPBMSAPI_ERR_0005     | 400           | Effective date value is invalid, format must be YYYY/MM/DD with a valid year, month and day                                                                                                                                                 | Update the effective date to the YYYY/MM/DD format                                                                                                                                                                   |
| BPBMSAPI_ERR_0006     | 400           | Request body is missing                                                                                                                                                                                                                     | Update the request body according to the specifications                                                                                                                                                              |
| BPBMSAPI_ERR_0007     | 400           | Biller ID specified is already in use, please resubmit with a different Biller ID value                                                                                                                                                     | Update with a biller id value that is not already in RPPS                                                                                                                                                            |
| BPBMSAPI_ERR_0008     | 400           | Effective date cannot be on a weekend or federal banking holiday                                                                                                                                                                            | Update the effective date to a business day that is not a federal holiday and at least 5 business days from the current date                                                                                         |
| BPBMSAPI_ERR_0009     | 400           | Effective date cannot be more than 7 business days in the future                                                                                                                                                                            | Update the effective date to a business day not a federal holiday and at least 5 business days from the current date and no more than 7 business days from the current date.                                         |
| BPBMSAPI_ERR_0010     | 400           | Effective date cannot be less than 5 business days in the future                                                                                                                                                                            | Update the effective date to a business day that is not a federal holiday and at least 5 business days from the current date                                                                                         |
| BPBMSAPI_ERR_0011     | 400           | Unrecognized field(s) present in the request                                                                                                                                                                                                | Update the request body according to the specifications                                                                                                                                                              |
| BPBMSAPI_ERR_0012     | 400           | Biller Class value is invalid, must be a valid value from the API YAML                                                                                                                                                                      | Update biller class to a valid class listed in the YAML file                                                                                                                                                         |
| BPBMSAPI_ERR_0013     | 400           | Biller Class value is invalid for specified line of business, must be a valid value from the API YAML                                                                                                                                       | Update biller class to a valid class listed in the YAML file                                                                                                                                                         |
| BPBMSAPI_ERR_0014     | 400           | RPPSID value does not exist in RPPS, please resubmit with a valid RPPSID                                                                                                                                                                    | Update RPPSID to an active, remote banking concentrator RPPSID                                                                                                                                                       |
| BPBMSAPI_ERR_0015     | 400           | RPPSID value is not active, please resubmit with an active RPPSID                                                                                                                                                                           | Update RPPSID to an active, remote banking concentrator RPPSID                                                                                                                                                       |
| BPBMSAPI_ERR_0016     | 400           | RPPSID value does not support Remote Banking payment transactions, please resubmit with a different RPPSID                                                                                                                                  | Update RPPSID to an active, remote banking concentrator RPPSID which supports payment transactions                                                                                                                   |
| BPBMSAPI_ERR_0018     | 400           | RPPSID value is invalid, must be 8 digits                                                                                                                                                                                                   | Update RPPSID to an active, remote banking concentrator RPPSID                                                                                                                                                       |
| BPBMSAPI_ERR_0019     | 400           | RPPSID value is invalid, must be numeric only                                                                                                                                                                                               | Update RPPSID to an active, remote banking concentrator RPPSID                                                                                                                                                       |
| BPBMSAPI_ERR_0020     | 400           | Biller ID is a required field                                                                                                                                                                                                               | Update Biller ID to a 10 digit value that is not already in RPPS                                                                                                                                                     |
| BPBMSAPI_ERR_0021     | 400           | Biller ID must be 10 digits                                                                                                                                                                                                                 | Update Biller ID to a 10 digit value that is not already in RPPS                                                                                                                                                     |
| BPBMSAPI_ERR_0022     | 400           | Biller ID value is invalid, must be numeric only                                                                                                                                                                                            | Update Biller ID to a 10 digit value that is not already in RPPS                                                                                                                                                     |
| BPBMSAPI_ERR_0023     | 400           | Biller Name is a required field                                                                                                                                                                                                             | Update Biller Name to a value between 1 and 128 characters                                                                                                                                                           |
| BPBMSAPI_ERR_0024     | 400           | Biller Name cannot exceed 128 characters                                                                                                                                                                                                    | Update Biller Name to a value between 1 and 128 characters                                                                                                                                                           |
| BPBMSAPI_ERR_0025     | 400           | Biller Name value is invalid, can only contain characters in the range of ASCII 32 to ASCII 126 and cannot use \|                                                                                                                           | Update Biller Name so that it contains only the allowed characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex)                      |
| BPBMSAPI_ERR_0026     | 400           | Batch Name cannot exceed 16 characters                                                                                                                                                                                                      | Update Batch Name to a value between 1 and 16 characters                                                                                                                                                             |
| BPBMSAPI_ERR_0027     | 400           | Batch Name value is invalid, can only contain characters in the range of ASCII 32 to ASCII 126 and cannot use \|                                                                                                                            | Update Batch Name so that it contains only the allowed characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex)                       |
| BPBMSAPI_ERR_0028     | 400           | Biller Class is a required field                                                                                                                                                                                                            | Update biller class to a valid class value listed in the YAML file                                                                                                                                                   |
| BPBMSAPI_ERR_0029     | 400           | Biller Class length must be 3 characters                                                                                                                                                                                                    | Update biller class to a valid class value listed in the YAML file                                                                                                                                                   |
| BPBMSAPI_ERR_0030     | 400           | Invalid Data                                                                                                                                                                                                                                | Update biller class to a valid class value listed in the YAML file                                                                                                                                                   |
| BPBMSAPI_ERR_0031     | 400           | Biller Type is a required field                                                                                                                                                                                                             | Update Biller Type to either 'CRE' or 'GTW'                                                                                                                                                                          |
| BPBMSAPI_ERR_0032     | 400           | Biller Type value is invalid, must be 'CRE' or 'GTW'                                                                                                                                                                                        | Update Biller Type to either 'CRE' or 'GTW'                                                                                                                                                                          |
| BPBMSAPI_ERR_0033     | 400           | Remittance RTN value is invalid, must be a numeric value                                                                                                                                                                                    | Update Remittance RTN to a 9 digit value or leave blank to default to '000000000'                                                                                                                                    |
| BPBMSAPI_ERR_0034     | 400           | Remittance RTN must be 9 digits                                                                                                                                                                                                             | Update Remittance RTN to a 9 digit value or leave blank to default to '000000000'                                                                                                                                    |
| BPBMSAPI_ERR_0035     | 400           | Remittance DDA can not contain only zeros                                                                                                                                                                                                   | Update Remittance DDA to contain a value between 1 and 17 digits                                                                                                                                                     |
| BPBMSAPI_ERR_0036     | 400           | Remittance DDA length must be between 1 and 17 digits                                                                                                                                                                                       | Update Remittance DDA to contain a value between 1 and 17 digits                                                                                                                                                     |
| BPBMSAPI_ERR_0037     | 400           | Remittance DDA value is invalid, must be a numeric value                                                                                                                                                                                    | Update Remittance DDA to contain a value between 1 and 17 digits                                                                                                                                                     |
| BPBMSAPI_ERR_0038     | 400           | PreNotes is a required field                                                                                                                                                                                                                | Update Prenotes to 'Y' or 'N'                                                                                                                                                                                        |
| BPBMSAPI_ERR_0039     | 400           | Prenotes value is invalid, must be 'Y' or 'N'                                                                                                                                                                                               | Update Prenotes to 'Y' or 'N'                                                                                                                                                                                        |
| BPBMSAPI_ERR_0040     | 400           | External Notes cannot exceed 1000 characters                                                                                                                                                                                                | Update External Notes to be between 1 and 1000 characters                                                                                                                                                            |
| BPBMSAPI_ERR_0041     | 400           | External Notes value is invalid, can only contain characters in the range of ASCII 32 to ASCII 126 and cannot use \|                                                                                                                        | Update External Notes so that it contains only the allowed characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex)                   |
| BPBMSAPI_ERR_0042     | 400           | At least one remittance address is required when adding a biller                                                                                                                                                                            | Update Remittance Address to ensure at least one Remittance Address is submitted                                                                                                                                     |
| BPBMSAPI_ERR_0043     | 400           | Biller remittance type is a required field                                                                                                                                                                                                  | Update Remittance Address Type to 'Sta' or 'Pre'                                                                                                                                                                     |
| BPBMSAPI_ERR_0044     | 400           | Client ID is invalid                                                                                                                                                                                                                        | Please correct the Client ID associated with this RPPSID and resubmit.                                                                                                                                               |
| BPBMSAPI_ERR_0045     | 400           | Address 1 is a required field                                                                                                                                                                                                               | Include an Address 1 value between 1 and 50 characters                                                                                                                                                               |
| BPBMSAPI_ERR_0046     | 400           | Address 1 length must be between 1 and 50 characters                                                                                                                                                                                        | Update Address 1 to be between 1 and 50 characters                                                                                                                                                                   |
| BPBMSAPI_ERR_0047     | 400           | Address 1 value invalid, must contain alpha-numeric characters only                                                                                                                                                                         | Update Address 1 to be between 1 and 50 characters or numbers without any special characters                                                                                                                         |
| BPBMSAPI_ERR_0048     | 400           | Address 2 length must be between 1 and 50 characters                                                                                                                                                                                        | Update Address 2 to be between 1 and 50 characters or numbers without any special characters                                                                                                                         |
| BPBMSAPI_ERR_0049     | 400           | Address 2 value is invalid, must contain alpha-numeric characters only                                                                                                                                                                      | Update Address 2 to be between 1 and 50 characters or numbers without any special characters                                                                                                                         |
| BPBMSAPI_ERR_0050     | 400           | Address 3 length must be between 1 and 50 characters                                                                                                                                                                                        | Update Address 3 to be between 1 and 50 characters or numbers without any special characters                                                                                                                         |
| BPBMSAPI_ERR_0051     | 400           | Address 3 value is invalid, must contain alpha-numeric characters only                                                                                                                                                                      | Update Address 3 to be between 1 and 50 characters or numbers without any special characters                                                                                                                         |
| BPBMSAPI_ERR_0052     | 400           | City is a required field                                                                                                                                                                                                                    | Update City to a valid city between 1 and 40 alphanumeric characters                                                                                                                                                 |
| BPBMSAPI_ERR_0053     | 400           | City length must be between 1 and 40 characters                                                                                                                                                                                             | Update City to a valid city between 1 and 40 alphanumeric characters                                                                                                                                                 |
| BPBMSAPI_ERR_0054     | 400           | City value is invalid, can only contain characters in the range of ASCII 32 to ASCII 126 and cannot use \|                                                                                                                                  | Update City to a valid city between 1 and 40 alphanumeric characters                                                                                                                                                 |
| BPBMSAPI_ERR_0055     | 400           | State is a required field                                                                                                                                                                                                                   | Please update State to one of the valid State Codes in the YAML                                                                                                                                                      |
| BPBMSAPI_ERR_0056     | 400           | State must be a valid state code as listed in the YAML file                                                                                                                                                                                 | Please update State to one of the valid State Codes in the YAML                                                                                                                                                      |
| BPBMSAPI_ERR_0057     | 400           | Postal Code is a required field                                                                                                                                                                                                             | Update Postal Code to a valid postal code in a valid format XXXXX, XXXXX-XXXX or XXXXXXXXXX                                                                                                                          |
| BPBMSAPI_ERR_0058     | 400           | Postal Code length must be between 1 and 10 characters                                                                                                                                                                                      | Update Postal Code to a valid postal code in a valid format XXXXX, XXXXX-XXXX or XXXXXXXXXX                                                                                                                          |
| BPBMSAPI_ERR_0059     | 400           | Postal Code value invalid, format must be XXXXX, XXXXX-XXXX or XXXXXXXXXX                                                                                                                                                                   | Update Postal Code to a valid postal code in a valid format XXXXX, XXXXX-XXXX or XXXXXXXXXX                                                                                                                          |
| BPBMSAPI_ERR_0060     | 400           | Mask length must be between 1 and 22 characters                                                                                                                                                                                             | Update Mask to have at least one mask with a length between 1 and 22 characters and the following characters are allowed: A-Z (capital only), 0-9, and the following special characters !@#\*-.                      |
| BPBMSAPI_ERR_0061     | 400           | Mask Format value is invalid, can only contain the following characters: A-Z (capital only), 0-9, and the following special characters !@#\*-.                                                                                              | Update Mask to have at least one mask with a length between 1 and 22 characters and the following characters are allowed: A-Z (capital only), 0-9, and the following special characters !@#\*-.                      |
| BPBMSAPI_ERR_0062     | 400           | At least one biller mask is required when adding a biller                                                                                                                                                                                   | Update Mask to have at least one mask with a length between 1 and 22 characters and the following characters are allowed: A-Z (capital only), 0-9, and the following special characters !@#\*-.                      |
| BPBMSAPI_ERR_0063     | 400           | AKA value is invalid, can only contain characters in the range of ASCII 32 to ASCII 126 and cannot use \|                                                                                                                                   | Update AKA to an AKA between 1-128 characters that contains only the allowed characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) |
| BPBMSAPI_ERR_0064     | 400           | AKA value is invalid, can only contain characters in the range of ASCII 32 to ASCII 126 and cannot use \|                                                                                                                                   | Update AKA to an AKA between 1-128 characters that contains only the allowed characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) |
| BPBMSAPI_ERR_0065     | 400           | One or more duplicate account masks were submitted                                                                                                                                                                                          | Review the payload for duplicate account masks.                                                                                                                                                                      |
| BPBMSAPI_ERR_0066     | 400           | Biller Record Action is a required field                                                                                                                                                                                                    | Add "billerRecordAction" to the request                                                                                                                                                                              |
| BPBMSAPI_ERR_0067     | 400           | Biller Record Action can only be 'Add', 'Edit' or 'Deactivate'                                                                                                                                                                              | Update "billerRecordAction" to 'Add', 'Edit' or 'Deactivate'                                                                                                                                                         |
| BPBMSAPI_ERR_0068     | 400           | Effective date is a required field                                                                                                                                                                                                          | Update the request and add the field 'effectiveDate'                                                                                                                                                                 |
| BPBMSAPI_ERR_0069     | 400           | Mask Format is a required field                                                                                                                                                                                                             | Update the request to include a mask                                                                                                                                                                                 |
| BPBMSAPI_ERR_0070     | 400           | RPPSID is a required field                                                                                                                                                                                                                  | Update the request body to include an RPPSID                                                                                                                                                                         |
| BPBMSAPI_ERR_0071     | 403           | Client ID does not have access to perform maintenance on billers for the specified RPPSID. Please contact RPPS customer service to ensure client ID is linked to RPPSID.                                                                    | Please contact RPPS customer service to ensure client ID is linked to RPPSID.                                                                                                                                        |
| BPBMSAPI_ERR_0072     | 403           | Client ID does not have access to manage billers                                                                                                                                                                                            | Your client key must be added to the Concentrator in the RPPS Biller Directory. Contact RPPS customer service to confirm that your Client ID is linked to your RPPSID.                                               |
| BPBMSAPI_ERR_0073     | 400           | Must contain at least one of # @ \* !                                                                                                                                                                                                       | Update mask format to use at least one of # @ \* !                                                                                                                                                                   |
| BPBMSAPI_ERR_0074     | 400           | Required field is missing                                                                                                                                                                                                                   | Validate all required fields are filled                                                                                                                                                                              |
| BPBMSAPI_ERR_0075     | 400           | Work Request ID must be a number between 1 and 19 characters                                                                                                                                                                                | Update Work Request ID to be a valid number between 1 - 19 characters                                                                                                                                                |
| BPBMSAPI_ERR_0076     | 403           | Client ID does not have access to request status on the specified Work Request ID                                                                                                                                                           | Your client key must be added to the Concentrator in the RPPS Biller Directory. Contact RPPS customer service to confirm that your Client ID is linked to the RPPSID that submitted the work request.                |
| BPBMSAPI_ERR_0077     | 400           | A valid address key should be sent when attempting to edit or delete an existing address                                                                                                                                                    | Retrieve the current address keys with GET `/biller/{biller_id}` and resubmit with a valid address key                                                                                                               |
| BPBMSAPI_ERR_0078     | 400           | Record Action is a required field                                                                                                                                                                                                           | Please update the record action field to a valid record action of 'Add', 'Edit' or 'Delete'                                                                                                                          |
| BPBMSAPI_ERR_0079     | 400           | A valid recordAction must be sent                                                                                                                                                                                                           | Please use 'Add', 'Edit' or 'Delete' for the recordAction                                                                                                                                                            |
| BPBMSAPI_ERR_0080     | 400           | Biller ID does not exist in RPPS or is not managed by your RPPS ID                                                                                                                                                                          | Update Biller ID to a 10 digit value that exists in RPPS and managed by your RPPS ID                                                                                                                                 |
| BPBMSAPI_ERR_0081     | 400           | This biller is inactive                                                                                                                                                                                                                     | You cannot manage this biller via the API. If you need to reactivate the biller, contact RPPS Support.                                                                                                               |
| BPBMSAPI_ERR_0082     | 400           | This biller has an active work request                                                                                                                                                                                                      | You cannot submit another work request until after the effective date                                                                                                                                                |
| BPBMSAPI_ERR_0083     | 400           | At least one address field should be provided when attempting to edit an existing address                                                                                                                                                   | Add at least one address field to edit                                                                                                                                                                               |
| BPBMSAPI_ERR_0084     | 400           | This address already exists, you cannot have duplicate addresses                                                                                                                                                                            | Please submit a unique address                                                                                                                                                                                       |
| BPBMSAPI_ERR_0085     | 400           | This action will lead to no standard addresses, you must have at least one standard biller address                                                                                                                                          | Please ensure you have at least one standard address                                                                                                                                                                 |
| BPBMSAPI_ERR_0086     | 400           | This mask already exists, you cannot have duplicate masks                                                                                                                                                                                   | Submit a unique mask. The submitted mask already exists.                                                                                                                                                             |
| BPBMSAPI_ERR_0087     | 400           | A valid mask key should be sent when attempting to edit or delete an existing mask                                                                                                                                                          | Retrieve the current mask keys with GET `/biller/{biller_id}` and resubmit with a valid mask key                                                                                                                     |
| BPBMSAPI_ERR_0088     | 400           | Masks cannot start with a dash '-'                                                                                                                                                                                                          | Resubmit the request with a valid mask                                                                                                                                                                               |
| BPBMSAPI_ERR_0089     | 400           | This mask description already exists, you cannot have duplicate mask descriptions                                                                                                                                                           | Resubmit with a unique mask description.                                                                                                                                                                             |
| BPBMSAPI_ERR_0090     | 400           | At least one mask field should be provided when attempting to edit an existing mask                                                                                                                                                         | Please enter a mask or mask description to edit                                                                                                                                                                      |
| BPBMSAPI_ERR_0091     | 400           | The aka name field should be provided when attempting to edit an existing aka                                                                                                                                                               | Add a valid aka name to the edit                                                                                                                                                                                     |
| BPBMSAPI_ERR_0092     | 400           | A valid aka key should be sent when attempting to edit or delete an existing aka                                                                                                                                                            | Retrieve the current aka keys with GET `/biller/{biller_id}` and resubmit with a valid aka key.                                                                                                                      |
| BPBMSAPI_ERR_0093     | 400           | This aka already exists, you cannot have duplicate akas                                                                                                                                                                                     | Please validate that you are sending unique akas                                                                                                                                                                     |
| BPBMSAPI_ERR_0094     | 400           | You must send a value in the AKA field when adding or editing the AKA                                                                                                                                                                       | Please ensure you have an aka value present                                                                                                                                                                          |
| BPBMSAPI_ERR_0095     | 400           | Deactivation Action is invalid, must be 'Address', 'Biller ID' or 'Stop Payment'                                                                                                                                                            | Please use a valid Deactivation Action                                                                                                                                                                               |
| BPBMSAPI_ERR_0096     | 400           | This forwardBillerId is not a valid active biller, please submit an active biller or a biller that has been submitted with an effective date equal to or less than the deactivation effective date                                          | Review the forward Biller. It may be inactive, or its active date may be later than the effective date of this deactivation.                                                                                         |
| BPBMSAPI_ERR_0097     | 400           | forwardBillerId is a required field when Biller Id is the deactivate reason                                                                                                                                                                 | Add a forwardBillerId for an active Biller when the deactivation reason is 'Biller ID'                                                                                                                               |
| BPBMSAPI_ERR_0098     | 400           | forwardBillerId value is invalid, must be 10 digits                                                                                                                                                                                         | Review the forward Biller. It may be inactive, or its active date may be later than the effective date of this deactivation.                                                                                         |
| BPBMSAPI_ERR_0099     | 400           | forwardBillerId value is invalid, must be numeric only                                                                                                                                                                                      | Review the forward Biller. It may be inactive, or its active date may be later than the effective date of this deactivation.                                                                                         |
| BPBMSAPI_ERR_0100     | 400           | This forward biller has a work request to deactivate. Please choose a valid active biller                                                                                                                                                   | Review the forward Biller. It already has a work request to deactivate it, so choose a different active Biller.                                                                                                      |
| BPBMSAPI_ERR_0101     | 400           | More than the maximum number of errors have occurred, please review all business rules                                                                                                                                                      | Please correct the errors returned                                                                                                                                                                                   |
| BPBMSAPI_ERR_0102     | 400           | You cannot have more than 50 AKAs on a biller profile, please reduce the number of AKAs                                                                                                                                                     | Please reduce the number of AKAs to 50 or less                                                                                                                                                                       |
| BPBMSAPI_ERR_0103     | 400           | You cannot have more than 50 Remittance Addresses on a biller profile, please reduce the number of Remittance Addresses                                                                                                                     | Please reduce the number of Remittance Addresses to 50 or less                                                                                                                                                       |
| BPBMSAPI_ERR_0104     | 400           | You cannot have more than 100 Masks on a biller profile, please reduce the number of Masks                                                                                                                                                  | Please reduce the number of Masks to 100 or less                                                                                                                                                                     |
| BPBMSAPI_ERR_0105     | 400           | You cannot have more than 3 Mask Descriptions for each Mask on a biller profile, please reduce the number of Mask Descriptions                                                                                                              | Please reduce the number of Mask Descriptions to 3 or less                                                                                                                                                           |
| BPBMSAPI_ERR_0106     | 400           | This Biller exceeds one of the array limits we have, you can only use UI to manage it                                                                                                                                                       | Reduce the number of records sent. If the Biller needs that many records, use the Biller Directory UI.                                                                                                               |
| BPBMSAPI_ERR_0107     | 400           | At least one field must be modified during an edit                                                                                                                                                                                          | Please ensure you are modifying at least one field                                                                                                                                                                   |
| BPBMSAPI_ERR_0108     | 400           | The Forward Biller ID to be used is not valid, please update the forwardBillerId to a 10 digit value that exists in RPPS and managed by your RPPS ID                                                                                        | Please validate the Biller is a valid biller that you manage                                                                                                                                                         |
| BPBMSAPI_ERR_0109     | 400           | The Forward Biller ID used is not valid for the RPPS IDs this Client ID is authorized to manage, please update the forwardBillerId to a 10 digit value that exists in RPPS and managed by one of the RPPS IDs authorized for your Client ID | Please validate the Biller is a valid biller that you manage                                                                                                                                                         |
| BPBMSAPI_ERR_0110     | 400           | Updates are only valid for active, remote banking billers, please update the biller id to an active remote banking biller                                                                                                                   | Please validate the Biller is a valid Remote Banking biller that you manage                                                                                                                                          |
| BPBMSAPI_ERR_0111     | 400           | RPPSID cannot be modified on a biller due to the complex logic in the API, please use the UI to change RPPS ID                                                                                                                              | Use the RPPS UI to make this edit. Contact support if you believe there is an issue.                                                                                                                                 |
| BPBMSAPI_ERR_0112     | 400           | This Biller ID is the Forward Biller ID in another deactivation that is currently in progress. Demote or abandon that work request before you schedule deactivation of this biller.                                                         | You must take action on the Forward Biller ID or choose another Forward Biller ID.                                                                                                                                   |
| BPBMSAPI_ERR_0113     | 400           | Mask Description value is invalid, can only contain characters in the range of ASCII 32 to ASCII 126 and cannot use \|                                                                                                                      | Remove the character(s) in question and resubmit.                                                                                                                                                                    |
| BPBMSAPI_ERR_0114     | 400           | Effective date cannot be less than 1 business day in the future                                                                                                                                                                             | You must change the effective date for this record (only applies to RPPS+ customers)                                                                                                                                 |
| BPBMSAPI_ERR_0115     | 400           | Account Conversion is active, Biller should not be deactivated.                                                                                                                                                                             | You cannot deactivate a biller with an active account conversion in place.                                                                                                                                           |
| BPBMSAPI_ERR_0116     | 400           | You cannot submit biller changes during non-business days.                                                                                                                                                                                  | Please submit during a business day.                                                                                                                                                                                 |
| BPBMSAPI_ERR_0117     | 400           | You cannot submit biller changes during restricted dates or holidays.                                                                                                                                                                       | Please submit during a valid business day.                                                                                                                                                                           |
| BPBMSAPI_ERR_0118     | 400           | You cannot submit biller changes after 23:00 US CT given there is not enough time to approve and activate the biller updates.                                                                                                               | Please submit during valid business hours.                                                                                                                                                                           |
| BPBMSAPI_ERR_0119     | 400           | This is not an active/live biller. For status, please use the Work Request Status request.                                                                                                                                                  | Please use the Work Request Status API call to validate.                                                                                                                                                             |

## Gateway Error Codes {#gateway-error-codes}

### Quick Reference: Common HTTP Errors {#quick-reference-common-http-errors}

| HTTP Status |                                     Likely Cause                                      |                                                          Resolution                                                          |
|-------------|---------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|
| **400**     | Malformed request body, invalid OAuth signature, or missing required fields           | Check request JSON format, verify OAuth 1.0a signature, ensure all required fields are present                               |
| **401**     | Invalid Consumer Key, expired/invalid Signing Key, or signature verification failed   | Verify Consumer Key matches project, regenerate .p12 Signing Key if expired, check key alias and password                    |
| **403**     | Authorization failed; your Concentrator account does not have access to the operation | Check the service reason code above. If none is returned, ask your Implementation Manager to verify your account permissions |
| **404**     | Endpoint URL is incorrect or biller/work Request ID does not exist                    | Use correct sandbox/MTF/production URL, verify biller and work request IDs exist                                             |
| **405**     | Wrong HTTP method (for example, GET instead of POST)                                  | Check that you are using the correct HTTP method for the endpoint                                                            |
| **500**     | Server-side error; usually temporary                                                  | Retry with exponential backoff after 1-2 seconds; contact support if error persists                                          |

### Complete Gateway Error Reference {#complete-gateway-error-reference}

The Mastercard gateway, which verifies the signature of your request and routes it, can also return error codes.

For the list of gateway errors and the resolution for each, see [Gateway Error Codes](https://developer.mastercard.com/platform/documentation/security-and-authentication/gateway-error-codes/).

## Date and Time Formats {#date-and-time-formats}

The expected date format is:

|         Date/Time Field          |   Format   |
|----------------------------------|------------|
| Full Date (Day, Month, and Year) | YYYY/MM/DD |

*** ** * ** ***

### RegEx {#regex}

* Characters in the range ASCII 32 to ASCII 126, excluding the pipe character (`|`)

## 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 scenarios
