# Code and Formats source: https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md This section describes errors that may be returned either from the gateway or the Remote Payment and Presentment Service (RPPS) Biller Maintenance Service. The error message format returned will depend on which API generated the error and at what point the request failed. Error messages will be in one of two formats depending on the type of error. 1. Application Error Messages - returned from the service application and typically occur for incorrect input. 2. Gateway Error Codes - returned from the gateway and typically occur when OAUTH authentication fails. ### Error Structure {#error-structure} Mastercard returns errors in the following structure. ```json { "Errors": { "Error": [ { "Source": "", "ReasonCode": "", "Description": "", "Recoverable": true/false, "Details": "" } ] } } ``` ## HTTP Response and Reason Codes {#http-response-and-reason-codes} ### Service Error Codes {#service-error-codes} | **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 effective date to 'YY/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 can not 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 the following special characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) | Update Biller Name and it may only contain the following special characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) | | BPBMSAPI_ERR_0026 | 400 | Batch Name can not 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 the following characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) | Update Batch Name and it may only contain the following special 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 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 in the yaml file | | BPBMSAPI_ERR_0030 | 400 | Invalid Data | Update biller class to a valid class value listed in 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 can not 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 the following characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) | Update External Notes value and it may only contain the following 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 in between 1 to 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 in between 1 to 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 in between 1 to 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 in between 1 to 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 the following characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) | 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 length 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 in between 1 to 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 should be in between 1 to 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 the following characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) | Update AKA to an AKA between 1-128 characters and it may only contain the following characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) | | BPBMSAPI_ERR_0064 | 400 | AKA can not exceed 128 characters | Update AKA to an AKA between 1-128 characters and it may only contain the following characters: [See RegEx](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/code-and-formats/index.md#regex) | | BPBMSAPI_ERR_0065 | 400 | Masks is a required block | Add a biller masks to the request | | BPBMSAPI_ERR_0066 | 400 | Biller Record Actions 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 | The client key you are must be added to the concentrator via the RPPS Biller Directory. Please contact RPPS customer service to ensure client ID is linked to 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 | The client key you are must be added to the concentrator via the RPPS Biller Directory | | BPBMSAPI_ERR_0077 | 400 | A valid address key should be sent when attempting to edit or delete an existing address | Please validate the address key and resubmit | | 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 | Update Biller ID to a 10 digit value that exists in RPPS and 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 | Please submit a unique mask, the one submitted already exists | | BPBMSAPI_ERR_0087 | 400 | A valid mask key should be sent when attempting to edit or delete an existing mask | Please ensure you are using the 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 | Please add a valid aka in the edit | | BPBMSAPI_ERR_0092 | 400 | A valid aka key should be sent when attempting to edit or delete an existing aka | Please ensure you have a valid | | 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 fwdBlrId 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 | Please review the biller you are submitting to use going forward. It may be inactive or does not have an active date equal to or less than the effective date for this deactivation | | BPBMSAPI_ERR_0097 | 400 | fwdBlrId is a required field when Biller Id is the deactivate reason | Please use an active biller when selecting 'Biller ID' | | BPBMSAPI_ERR_0098 | 400 | fwdBlrId value is invalid, must be 10 digits | Please review the biller you are submitting to use going forward. It may be inactive or does not have an active date equal to or less than the effective date for this deactivation | | BPBMSAPI_ERR_0099 | 400 | fwdBlrId value is invalid, must be numeric only | Please review the biller you are submitting to use going forward. It may be inactive or does not have an active date equal to or less than the effective date for this deactivation | | BPBMSAPI_ERR_0100 | 400 | This forward biller has a work request to deactivate. Please choose a valid active biller | Please review the biller you are submitting to use going forward. The biller presented appears to be in a work order to deactivate | | BPBMSAPI_ERR_0101 | 400 | More than %d 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 | Please review the number of records sent, if mandatory to have that many, please 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 | Please use the UI to manage this edit, contact support if you believe there is an issue | ## Gateway Error Codes {#gateway-error-codes} In addition to service error codes, error codes can also be returned by Mastercard's gateway, which is used to verify your request's signature, and route it to the correct location. You can find a list of the errors returned by our Gateway, as well as resolutions to each, on the following page [Gateway Error Codes](https://developer.mastercard.com/platform/documentation/security-and-authentication/gateway-error-codes/). ## Date and Time Formats {#date-and-time-formats} Below is the expected format for the date: | Date/Time Field | Format | |----------------------------------|------------| | Full Date (Day, Month, and Year) | YYYY-MM-DD | *** ** * ** *** ### RegEx {#regex} * A-Za-z0-9\[\[\[\]\]\`\~!@#$\&\*=[{}]()+\\/.;:?,."_\\"' -