# Editing a Biller
source: https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/use-cases/edit-biller/index.md

### Edit Biller {#edit-biller}

Concentrators can edit their existing billers via the Remote Payment and Presentment Service (RPPS) Biller Maintenance Service directly from their system. The API will ensure all the business rules are being met, and if not, will advise the Concentrator when issues arise and how to correct them. This is accomplished by calling the biller-request path.

### Step-by-Step Workflow {#step-by-step-workflow}

**Step 1:** Retrieve the current biller details using GET `/biller/{biller_id}` (this is required to get internal keys for updating)
**Step 2:** Update the desired fields (billerClass, notes, addresses, masks, etc.)
**Step 3:** Call POST `/biller-request` with action "Edit" and updated biller details
**Step 4:** Receive Work Request ID if successful
**Step 5:** Monitor the Work Request Status until approved
**Step 6:** Once approved and effective date passed, changes take effect in RPPS

#### Rationale {#rationale}

The Edit Biller endpoint requires you to first retrieve current biller information (including internal keys) via GET `/biller/{biller_id}`. This ensures you're working with the latest version and maintaining data consistency. Changes require approval similar to Add Biller, with a 5+ business day SLA.

#### API Reference {#api-reference}


API Reference: `POST /biller-request`

## Edit Biller Info {#edit-biller-info}

### Request - Static Test Data {#request---static-test-data}

Below is an example request body for editing biller information.

```json
{
  "billerRecordAction": "Edit",
  "effectiveDate": "2030/12/31",
  "rppsBiller": {
    "billerInfo": {
      "rppsId": "01234567",
      "billerId": "0123456789",
      "billerClass": "AFI",
      "preNotes": "Y",
      "externalNotes": "Please remove all dashes from the consumer's account number before matching to the RPPS account mask and sending the payment."
    }
  }
}
```

### Response - Success {#response---success}

```json
{
  "billerRecordAction": "Edit",
  "billerId": "0123456789",
  "statusIndicator": "SUCCESS",
  "statusDescription": "Successfully created workflow request",
  "workRequestId": 100001,
  "effectiveDate": "2030/12/31"
}
```

### Response - Error {#response---error}

The following example shows the error returned when your Client ID does not have access to manage Billers:

```json
{
  "Errors": {
    "Error": [
      {
        "Source": "RPPS Biller Maintenance Service",
        "ReasonCode": "BPBMSAPI_ERR_0072",
        "Description": "Access Denied",
        "Recoverable": false,
        "Details": "Client ID does not have access to manage billers"
      }
    ]
  }
}
```

## Next Steps {#next-steps}

For what is required in the payload, please refer to [Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/add-biller-parameters/index.md).

Please continue to [Work Request Status](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/use-cases/work-request-status/index.md).