# JPMC-PDP Documentation from https://developer.payments.jpmorgan.com

# Manage check revoke

In this tutorial, you'll learn how to submit check revoke request for reconciliation and positive pay.

- Check revoke with escheatment data request

- Check revoke without escheatment data request

## Before you begin

To submit check revoke requests, you need the following: 

- A registered and fully onboarded Developer Account on the J.P. Morgan Payments Developer Portal.

- An active project that provides you with the credentials used to make a request.

## Send a request

Use the following example to submit a standard check revoke requests without escheatment of product code data.

### Stop revoke request using StopID

Use the following example to submit a request to revoke a previously placed stop payment by providing the unique `StopID`. This approach allows you to cancel the stop payment instruction associated with the specified `StopID`, enabling the check or range of checks to be processed as usual. To do this, call a `POST` request to the `/checks/stop/revoke` endpoint. 

```json
{
  "operationType": "ID",
  "stopId": "1234567890123456789"
}
```

### Single stop revoke request

<span style="font-weight: normal;">Use the following example to submit a request to revoke a stop payment for a single check by providing all relevant details, such as account number and check number. To do this, call a `POST` request to the `/checks/stop/revoke` endpoint.</span>

```json
{
  "operationType": "DETAIL",
  "debtor": {
    "accountNumber": "1234567890",
    "financialInstitutionId": {
      "id": "021000021",
      "idType": "USABA"
    }
  },
  "type": "SINGLE",
  "check": {
    "checkNumber": "123456666"
  }
}
```

### Single stop revoke request with specific amount

Use the following example to submit a request to revoke a stop payment for a single check by specifying the check amount. This approach is helpful when you know the exact amount of the check, allowing you to accurately identify and remove the stop payment instruction for the check matching the specified amount. To do this, call a `POST` request to the `/checks/stop/revoke` endpoint. 

```json
{
  "operationType": "DETAIL",
  "debtor": {
    "accountNumber": "1234567890",
    "financialInstitutionId": {
      "id": "021000021",
      "idType": "USABA"
    }
  },
  "type": "SINGLE",
  "check": {
    "checkNumber": "123456666"
  },
  "checkAmount": {
    "currency": "CAD",
    "amount": "100.00"
  }
}
```

### Single stop revoke request with payee only

Use the following example to submit a request to revoke a stop payment for a single check by providing only the payee information. This approach is useful when you have payee details, enabling you to remove the stop payment instruction for the check issued to that payee. To do this, call a `POST` request to the `/checks/stop/revoke` endpoint. 

```json
{
  "operationType": "DETAIL",
  "debtor": {
    "accountNumber": "1234567890",
    "financialInstitutionId": {
      "id": "021000021",
      "idType": "USABA"
    }
  },
  "type": "SINGLE",
  "check": {
    "checkNumber": "123456666"
  },
  "payees": [
    {
      "name": "John Doe",
      "priority": 1
    },
    {
      "name": "ELITE CORP",
      "priority": 2
    }
  ]
}
```

### Range stop revoke request

Use the following example to submit a request to revoke stop payments for a range of checks by specifying the starting and ending check numbers. To do this, call a `POST` request to the `/checks/stop/revoke` endpoint.

```json
{
  "operationType": "DETAIL",
  "debtor": {
    "accountNumber": "1234567890",
    "financialInstitutionId": {
      "id": "021000021",
      "idType": "USABA"
    }
  },
  "type": "RANGE",
  "check": {
    "checkRange": {
      "start": "10020",
      "end": "10030"
    }
  }
}
```

### Single stop revoke request with full details

Use the following example to submit a request to revoke a stop payment for a single check by providing all required details, such as account number, check number, amount, and payee information. To do this, call a `POST` request to the `/checks/stop/revoke` endpoint.

```json
{
  "operationType": "DETAIL",
  "debtor": {
    "accountNumber": "1234567890",
    "financialInstitutionId": {
      "id": "021000021",
      "idType": "USABA"
    }
  },
  "type": "SINGLE",
  "check": {
    "checkNumber": "123456666"
  },
  "checkAmount": {
    "currency": "CAD",
    "amount": "100.00"
  },
  "payees": [
    {
      "name": "John Doe",
      "priority": 1
    },
    {
      "name": "ELITE CORP",
      "priority": 2
    }
  ]
}
```

## Related

- For more information about check stop and revoke, see [Check Stop and Revoke Overview](/docs/treasury/receivables/capabilities/request-to-pay-via-qr-code/overview).

- For more information about status responses and error codes supported by the Checks API, see [Error Codes](/api/treasury/checks/error-codes).

- For more information about check stop and revoke resources, see [Resources](/docs/treasury/checks/capabilities/stop-and-revoke/resources).