Request account confidence score
In this tutorial, you will learn how to request an Account Confidence Score (ACS) that provides an indicator of the likelihood of fraud on a beneficiary account. By the end of this tutorial, you will know how to:
- Send an ACS-only request.
- Send an account confidence request with account verification and authentication.
ACS is only available for accounts based in the United States.
Before you begin
To retrieve an ACS, you will 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 to make a request.
Request ACS
Account status validation assesses a bank account and generates an ACS. The response includes a score from 0 through 1000 and a corresponding RED, AMBER, or GREEN RAG status. To request an ACS, send a POST request to /v2/validations/accounts.
[
{
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"profileName": "verification",
"account": {
"accountNumber": "1234559",
"financialInstitutionId": {
"clearingSystemId": {
"id": "073903354",
"idType": "ABA"
}
}
}
}
]The following example shows a sample ACS-only request
[
{
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"account": {
"accountNumber": "1233947",
"financialInstitutionId": {
"clearingSystemId": {
"id": "102000076",
"idType": "ABA"
}
}
}
}
]The following example shows an ACS response from the JPMC_BENE provider. The providerResponse includes a reasonCodes array that provides additional information about the result.
[
{
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"responses": [
{
"codes": {
"accountScore": {
"code": 1109,
"message": "Information Found"
}
},
"provider": "JPMC_BENE",
"details": {
"providerResponse": {
"score": 199,
"rag": "RED",
"reasonCodes": [
{
"code": "R0100",
"message": "Account exhibits similar transaction patterns to others that have been identified as high risk."
},
{
"code": "R0900",
"message": "Unexpected payment behavior identified as an account with high risk of fraud."
},
{
"code": "R0400",
"message": "Payments to relatively limited number of counterparties."
}
],
"description": "The account is in a low-confidence score range."
}
}
}
]
}
]A lower score indicates lower confidence in the beneficiary account. Review the score, rag, description, and reasonCodes together when evaluating the result.
For applicable responses from the JPMC_BENE provider, providerResponse includes a reasonCodes array that provides additional information about the account confidence result. A response can include multiple reason codes. Each item includes a code and a corresponding message.
Request ACS and authenticate account owner
Adding account owner authentication to the account confidence request evaluates the name on the account in addition to generating an ACS. To do this, call a POST request to /v2/validations/accounts. The following example includes the required fields for an account verification request.
[
{
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"account": {
"accountNumber": "12345",
"financialInstitutionId": {
"clearingSystemId": {
"id": "122199983",
"idType": "ABA"
}
}
},
"entity": {
"individual": {
"firstName": "Jane",
"lastName": "Abbot",
"fullName": "Jane Abbot"
}
},
"transactions": []
}
]The following example shows a response with account verification and an ACS.
[
{
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"responses": [
{
"codes": {
"verification": {
"code": 1001,
"message": "Open Valid"
}
},
"provider": "JPMC_ACH",
"details": {
"accountNumber": "XXXX5",
"financialInstitutionId": {
"clearingSystemId": {
"id": "122199983",
"idType": "ABA"
}
}
}
},
{
"codes": {
"accountScore": {
"code": 1109,
"message": "Information Found"
}
},
"provider": "JPMC_BENE",
"details": {
"providerResponse": {
"score": 199,
"rag": "RED",
"reasonCodes": [
{
"code": "R0100",
"message": "Account exhibits similar transaction patterns to others that have been identified as high risk."
},
{
"code": "R0900",
"message": "Unexpected payment behavior identified as an account with high risk of fraud."
},
{
"code": "R0400",
"message": "Payments to relatively limited number of counterparties."
}
],
"description": "The account is in a low-confidence score range."
}
}
}
]
}
]Successful response messages
An HTTP status of 200 indicates a successful response. The following fields indicate the result:
responseStatusresponseCoderesponseMessage
Related
- For more information about parameters, see Account Validation parameters.
- For more information about the status responses and error codes supported by the Validation Services API, see Validation Services error response codes.