Skip to main content
Checks

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. 

Stop revoke request using StopID
Json
{
  "operationType": "ID",
  "stopId": "1234567890123456789"
}

Single stop revoke request

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.

Single stop revoke request
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. 

Single stop revoke request with payee only
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.

Range stop revoke request
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.

Single stop revoke request with full details
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
    }
  ]
}
  • For more information about check stop and revoke, see Check Stop and Revoke Overview.
  • For more information about status responses and error codes supported by the Checks API, see Error Codes.
  • For more information about check stop and revoke resources, see Resources.
Is this page helpful?