Skip to main content

Error Codes

Overview​

This section provides a complete list of error codes returned by the PayCenter API.

Error Response Body​

All error responses return a MessageStatus object:

{
"responseCode": 400,
"description": "BadRequest",
"messageSource": "PayCenter API",
"details": [
{
"code": "PA-1003",
"category": "Error",
"description": "Identifier is missing",
"element": "Identifier",
"elementValue": null,
"location": "/api/limits/v2/institutions/123456789/environments/production/products/faster-payments/user/limits"
}
]
}

some of the code field can also come back as a plain numeric value with no PA- prefix:

{
"responseCode": 404,
"description": "NotFound",
"messageSource": "PayCenter API",
"details": [
{
"code": "2048",
"category": "Error",
"description": "Identifier not found",
"element": "ExternalIdentifier",
"elementValue": null,
"location": "/api/limits/v2/institutions/123456789/environments/production/products/faster-payments/user/limits"
}
]
}

Error Codes​

Bad Request (400)
CodeDescription
PA-1001The request body cannot be null.
PA-1002The provided identifier is invalid.
PA-1003An identifier is required but was not provided.
PA-1005The routing number is not a valid 9-digit ABA number.
PA-1007The Direction field is required.
PA-1008The LimitScope field is required.
PA-1009The limits array is required and cannot be empty.
PA-1010Each limit entry must include a type.
PA-1011Each limit entry must include a range.
PA-1012The limitValue must be greater than zero.
PA-1015The PaymentNetwork header is required.
PA-1017The X-Correlation-ID header is required.
PA-1018The X-Request-ID header is required.
PA-1019The env path parameter does not match the configured environment.
PA-1020The limitValue is required for add/update operations.
PA-1021The PaymentNetwork header value is not a supported network. Only Zelle is accepted.
PA-1022The LimitScope value is not supported. Only User is accepted for mutations.
PA-1023The Direction value is not supported. Only Outbound is accepted for mutations.
PA-1024The type value is not a recognized LimitType enum value.
PA-1025The range value is not a recognized LimitRange enum value.
PA-1026The X-AuditUserId header is required.
PA-1027The ExternalIdentifierType is missing or not a recognized value.
PA-1028External identifier validation error.
PA-1029The CoreCustomerID value is invalid (blank or whitespace).
PA-1030The ProductType value is invalid; accepted values are P2P or SMB.
PA-1031ProductType is required for SMB product-enabled financial institutions.
PA-1032The SMB product type is not enabled for this institution.
2006The Token identifier must be provided.
2007The Token identifier should not be empty.
2008The Token identifier is not a valid phone number.
2009The Token identifier is not a valid email address.
2056The Token identifier is not a valid Zelle tag.
4055The TaxId identifier must be provided.
4056The TaxId identifier should not be empty.
4057The TaxId identifier is not a valid 9-digit tax ID.
4073User not found (no customer matches the provided TaxId/CoreCustomerID combination).
4062The CoreCustomerID does not match the customer resolved for the provided TaxId.
4063The customer's registered profile type does not match the requested ProductType.
4064The customer resolved for the identifier is not active.
4065The CoreCustomerID does not match the customer resolved for the provided Token.
4066Multiple active customers were found for the identifier; CoreCustomerID is required to disambiguate.
2048The Token identifier was not found.
4058The Token identifier has no active payment profile.
2022The limits array is required and cannot be empty.
2034One or more duplicate limits (same type/range) were found in the request.
4059A FundingCap limit value exceeds the maximum allowed threshold of $9,999,999.
4060A FundingVelocity limit value exceeds the maximum allowed threshold of 999,999.
Not Found (404)
CodeDescription
PA-1014The specified limit was not found.
PA-1016The routing number was not found in the Zelle organization registry.
2006The Token identifier must be provided.
2007The Token identifier should not be empty.
2008The Token identifier is not a valid phone number.
2009The Token identifier is not a valid email address.
2056The Token identifier is not a valid Zelle tag.
4055The TaxId identifier must be provided.
4056The TaxId identifier should not be empty.
4057The TaxId identifier is not a valid 9-digit tax ID.
4073User not found (no customer matches the provided TaxId/CoreCustomerID combination).
4062The CoreCustomerID does not match the customer resolved for the provided TaxId.
4063The customer's registered profile type does not match the requested ProductType.
4064The customer resolved for the identifier is not active.
4065The CoreCustomerID does not match the customer resolved for the provided Token.
4066Multiple active customers were found for the identifier; CoreCustomerID is required to disambiguate.
2048The Token identifier was not found.
4058The Token identifier has no active payment profile.
Conflict (409)
CodeDescription
PA-1013A limit with the given type/range already exists for this user.
Internal Server Error (500)
CodeDescription
PA-0Unclassified / unknown error.