Entity Errors

​

Request Errors

The request to the /entities/:ent_id endpoint failed. These are the sub_type that can be returned.

​

INVALID_REQUEST

The request body failed basic validation for the specific API endpoint.

​

NOT_FOUND

The requested resource does not exist.

​

DUPLICATE_ENTITY_DETAILS

An Entity with the same details already exists.

​

INVALID_ENTITY_PHONE_NUMBER

The provided phone number is not a valid US phone number.

​

INVALID_ENTITY_EMAIL_ADDRESS

The provided email address is not a valid email address.

​

RESTRICTED_ENTITY_DETAILS

The Entity’s information does not match the restrictions set for your organization.

​

ENTITY_CONSENT_ALREADY_WITHDRAWN

Consent for this Entity has already been withdrawn.

​

ENTITY_CONSENT_ALREADY_GRANTED

Consent for this entity has already been granted.

​

ENTITY_HAS_PAYMENTS_IN_PROGRESS

Consent for this entity cannot be withdrawn as it has one or more associated payments in progress.

​

ENTITY_INVALID_SSN

The provided SSN is invalid. Verify your request and try again.

​

ENTITY_INVALID_SSN4

The provided SSN4 is invalid. Verify your request and try again.

​

ENTITY_CREDIT_SCORE_NOT_FOUND

The credit score for this entity could not be found.

​

MAX_ENTITY_METADATA_SIZE_EXCEEDED

The max metadata object size of 1KB was exceeded.

​

ENTITY_UPDATE_RESTRICTED

Only Entity’s that have consented can be updated.

​

ENTITY_UPDATE_DISABLED

Disabled Entities cannot be updated.

​

ENTITY_UPDATE_INVALID

Cannot update an Entity’s field that has already been set.

​

ENTITY_UPDATE_UNSUPPORTED

This Entity cannot be updated.

​

Resource Errors

Errors set on an Entity’s error property for processes that are unsuccessful.

​

12001 – ENTITY_UNAUTHORIZED_PAYMENT

The Entity was disabled due to unauthorized payments which was reported by the FI.

​

Causes

• Customer Revoked Authorization
• Originator not known and/or not authorized to Debit Receiver’s Account
• Representative Payee Deceased or Unable to Continue in That Capacity
• Corporate Customer Advises Not Authorized

{
  "type": "ENTITY_DISABLED",
  "code": 12001,
  "sub_type": "ENTITY_UNAUTHORIZED_PAYMENT",
  "message": "Entity was disabled due to a payment reported as unauthorized by the financial institution."
}

​

Resolution

The Entity will be disabled and all its capabilities will be removed.

​

12002 – ENTITY_INVALID_DETAILS

The Entity was disabled due to the information provided being invalid.

​

Causes

• One or more PIIs provided were invalid.

{
  "type": "ENTITY_DISABLED",
  "code": 12002,
  "sub_type": "ENTITY_INVALID_DETAILS",
  "message": "Entity was disabled due to invalid information."
}

​

Resolution

The Entity will be disabled and no capabilities will be granted.

​

12003 – ENTITY_PENDING_KYC_REVIEW

The Entity was disabled due Method’s provider needing to review the Entity’s KYC information.

​

Causes

• The Entity has been flagged for requiring a KYC review.

{
  "type": "ENTITY_DISABLED",
  "code": 12003,
  "sub_type": "ENTITY_PENDING_KYC_REVIEW",
  "message": "Entity was disabled due to pending KYC review."
}

​

Resolution

The Entity will be disabled and no capabilities will be granted.

​

12004 – ENTITY_SSN_MISMATCH

The Entity was disabled due to the PII provided not matching the identity the SSN belongs to.

​

Causes

• SSN provided does not match the Entity’s identity.

{
  "type": "ENTITY_DISABLED",
  "code": 12004,
  "sub_type": "ENTITY_SSN_MISMATCH",
  "message": "Entity was disabled due to a mismatch in the provided and retrieved social security number."
}

​

Resolution

The Entity will be disabled and no capabilities will be granted.

​

12005 – ENTITY_CONSENT_WITHDRAWN

The Entity was disabled due to consent being withdrawn.

​

Causes

• The Entity has withdrawn consent.

{
  "type": "ENTITY_DISABLED",
  "code": 12005,
  "sub_type": "ENTITY_CONSENT_WITHDRAWN",
  "message": "Entity was disabled due to consent withdrawal."
}

​

Resolution

The Entity will be disabled and all its capabilities will be removed.