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

### Deactivating Biller {#deactivating-biller}

Concentrators can deactivate billers via the Remote Payment and Presentment Service (RPPS) Biller Maintenance Service directly from their system. This removes the biller from the active RPPS 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:** Identify the biller to deactivate and optionally a forwarding biller ID (if payments should redirect)
**Step 2:** Call POST `/biller-request` with action "Deactivate" and biller ID
**Step 3:** Receive Work Request ID if successful
**Step 4:** Monitor the Work Request Status until approved
**Step 5:** Once effective date passes, biller is deactivated in RPPS and no longer available for payments
**Step 6:** Any forwarding biller specified will receive redirected payment requests

#### Rationale {#rationale}

The Deactivate Biller endpoint allows you to remove a biller from the system while optionally redirecting future payment attempts to a replacement biller. This is useful when consolidating accounts or removing incorrect biller records. Deactivation requires approval similar to Add/Edit actions.

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


API Reference: `POST /biller-request`

## Deactivating a Biller {#deactivating-a-biller}

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

Below is an example request body for deactivating a biller.

```json
{
  "billerRecordAction": "Deactivate",
  "effectiveDate": "2030/12/31",
  "rppsBiller": {
    "billerInfo": {
      "billerId": "0123456789"
    },
    "deactivation": {
      "deactivationReason": "Biller ID",
      "forwardBillerId": "9876543210"
    }
  }
}
```

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

```json
{
  "billerRecordAction": "Deactivate",
  "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).