Instant Payment Errors
Docs
>
Payments
>
Payments
>
Instant Payment Errors
Possible Instant Payment Errors
| Class Name | Field | Constraint Type | Error | HTTP/Error Status Code | Payments Orchestrator / JH Error | Error Explanation | Corrective Action |
|---|---|---|---|---|---|---|---|
| InstantPaymentAccountDetails | accountNumber | Blank | error.accountNumber.blank | 400 | Payments Orchestrator | Account Number field is empty | Ensure Account Number field is not empty |
| InstantPaymentAccountDetails | accountNumber | Size | error.accountNumber.size | 400 | Payments Orchestrator | Account Number is too short or too long | Account number size: min = 3, max = 20 |
| InstantPaymentAccountDetails | accountNumber | Pattern | error.accountNumber.invalid | 400 | Payments Orchestrator | Account Number does not meet required format | The Payments Orchestrator system accepts account numbers that can include any combination of letters (both uppercase and lowercase), numbers, dots (.), slashes (/), parentheses (), ampersands (&), single quotes ('), spaces, and hyphens (-) |
| InstantPaymentAccountDetails | routingNumber | Blank | error.routingNumber.blank | 400 | Payments Orchestrator | Routing Number field is empty | Ensure Routing Number field is not empty |
| InstantPaymentAccountDetails | routingNumber | Size | error.routingNumber.size | 400 | Payments Orchestrator | Routing Number is too short or too long | Routing number size: min = 9, max = 9 |
| InstantPaymentAccountDetails | routingNumber | Pattern | error.routingNumber.invalid | 400 | Payments Orchestrator | Routing Number does not meet required format | Our system expects a routing number that is exactly 9 digits long and only includes number 0-9 |
| InstantPaymentCreditPayee | victorCounterpartyId | Blank | error.victorCounterpartyId.blank | 400 | Payments Orchestrator | Counterparty field is empty | Ensure Counterparty field is not empty |
| InstantPaymentCreditPayee | victorCounterpartyId | Size | error.victorCounterpartyId.size | 400 | Payments Orchestrator | Counterparty field is too long | The Payments Orchestrator system accepts a counterpartyId that has has a maximum of 16 characters and can include any combination of letters (both uppercase and lowercase) and numbers (0-9). |
| InstantPaymentCreditPayee | ultimateCreditor | Size | error.ultimateCreditor.size | 400 | Payments Orchestrator | UltimateCreditor field is too long | The Payments Orchestrator system accepts an UltimateCreditor description that has a maximum of 100 characters. This can only be included if the originator_type is BUSINESS |
| InstantPaymentCreditPayer | accountNumber | Blank | error.accountNumber.blank | 400 | Payments Orchestrator | Account Number field is empty | Ensure Account Number field is not empty |
| InstantPaymentCreditPayer | accountNumber | Size | error.accountNumber.size | 400 | Payments Orchestrator | Account Number is too short or too long | Account number size: min = 3, max = 20 |
| InstantPaymentCreditPayer | accountNumber | Pattern | error.accountNumber.invalid | 400 | Payments Orchestrator | Account Number does not meet required format | The Payments Orchestrator system accepts account numbers that can include any combination of letters (both uppercase and lowercase), numbers, dots (.), slashes (/), parentheses (), ampersands (&), single quotes ('), spaces, and hyphens (-) |
| InstantPaymentCreditPayer | ultimateDebtor | Size | error.ultimateDebtor.size | 400 | Payments Orchestrator | UltimateDebtor field is too long | The Payments Orchestrator system accepts an UltimateDebtorr description that has a maximum of 100 characters. This can only be included if the originator_type is BUSINESS |
| InstantPaymentCreditPaymentDetails | amount | Blank | error.amount.blank | 400 | Payments Orchestrator | Amount field is empty | Ensure Amount field is not empty |
| InstantPaymentCreditPaymentDetails | amount | Pattern | error.amount.invalid | 400 | Payments Orchestrator | Amount field does not meet required format | The Payments Orchestrator system accepts an Amount that is either a whole number (i.e 10, 100) or decimal number (i.e 10.10, 100.10) |
| InstantPaymentCreditPaymentDetails | originatorType | Null | error.originatorType.null | 400 | Payments Orchestrator | OriginatorType field is empty | Ensure OriginatorType field is not empty |
| InstantPaymentCreditPaymentDetails | originatorType | Enum Pattern | error.originatorType.invalid | 400 | Payments Orchestrator | OriginatorType field does not meet expected value | The Payments Orchestrator system expects an OriginatorType field that is either BUSINESS or CONSUMER (case sensitive). |
| InstantPaymentCreditPaymentDetails | notes | Size | error.notes.size | 400 | Payments Orchestrator | Notes field is too long | The Payments Orchestrator system accepts a Notes field that has a maximum of 150 characters. |
| InstantPaymentCreditPaymentRequest | clientReferenceId | Size | error.clientReferenceId.size | 400 | Payments Orchestrator | ClientReferenceID field is too long | The Payments Orchestrator system accepts a ClientReferenceID that is 128 characters long |
| InstantPaymentRefundRequest | victorTransactionId | Blank | error.victorTransactionId.blank | 400 | Payments Orchestrator | victorTransactionId is empty | Ensure victorTransactionId is not empty |
| InstantPaymentRefundRequest | victorTransactionId | Size | error.victorTransactionId.size | 400 | Payments Orchestrator | victorTransactionId is too long | victorTransactionId has a maximum of 36 characters |
| InstantPaymentRefundRequest | reasonCode | Blank | error.reasonCode.blank | 400 | Payments Orchestrator | ReasonCode field is empty | Ensure ReasonCode field is not empty |
| InstantPaymentRefundRequest | reasonCode | Size | error.reasonCode.size | 400 | Payments Orchestrator | ReasonCode field too long | ReasonCode field can have a maximum of 4 characters |
| InstantPaymentRefundRequest | reasonCode | Pattern | error.reasonCode.invalid | 400 | Payments Orchestrator | ReasonCode field does not meet expected value | Technical error, contact Payments Orchestrator support. |
| InstantPaymentRefundRequest | notes | Size | error.notes.size | 400 | Payments Orchestrator | Notes field is too long | The Payments Orchestrator system accepts a Notes field that has a maximum of 150 characters. Notes field can include any combination of letters (both uppercase and lowercase), numbers, dots (.), slashes (/), parentheses (), ampersands (&), single quotes ('), spaces, and hyphens (-) |
| InstantPaymentRefundRequest | clientReferenceId | Size | error.clientReferenceId.size | 400 | Payments Orchestrator | ClientReferenceID field is too long | The Payments Orchestrator system accepts a ClientReferenceID that is 128 characters long and |
| General InstantPayment Errors | error.InstantPayment.payment | 634 | Payments Orchestrator | Two possible reasons for this error: 1. Unable to create Instant Payment transaction 2. Thread interrupt while waiting to retry Instant Payment action | Possible technical error, please try again. If it persists please contact Payments Orchestrator support. | ||
| General InstantPayment Errors | error.get.InstantPayment.bank.details | 635 | Jack Henry | Unable to getBankDetails from InstantPaymentServer | Confirm recipient is on the Instant Payment network and try again later. If the issue persists contact Payments Orchestrator support. | ||
| General InstantPayment Errors | error.InstantPayment.failed | 636 | Jack Henry | Two possible reasons for this error: 1. The Payments Orchestrator system received a failed status when querying Instant Payment transaction against Jack Henry 2. The payment was rejected by the receiving institution | Ensure valid and active counterparty and try again later. | ||
| General InstantPayment Errors | error.invalid.InstantPayment.account.number | 632 | Payments Orchestrator | Instant Payment Account Number is invalid for counterparty id | Ensure counterparty has correct and valid Instant Payment Account Number | ||
| General InstantPayment Errors | error.invalid.InstantPayment.due.date | 633 | Payments Orchestrator | Due date cannot be more than 365 days from current date and it cannot be in the past | Ensure due date is withing the allowed time span and it's correctly formatted as "yyyy-mm-dd". | ||
| General InstantPayment Errors | error.invalid.InstantPayment.routing.number | 640 | Jack Henry | Routing Number does not support Instant Payment payments generally or the specific payment type (Credit Transfer, Refund, Payment Request) | Ensure routing number is valid and capable of Instant Payment payments or the specific payment type being executed. If you have validated that the routing number should support Instant Payment and you are still experiencing this error, please reach out to support to ensure configuration is correct on our end. | ||
| General InstantPayment Errors | error.bank.not.in.InstantPayment | 643 | Jack Henry | Bank not part of Instant Payment Network/Not signed on to Instant Payment network | Ensure financial institution is capable of Instant Payment payments | ||
| General InstantPayment Errors | error.InstantPayment.refund.alreadyExists | 429 | Payments Orchestrator | Transaction refund already exists | Ensure that a refund is not being duplicated. |
Did this page help you?
Last updated Fri Aug 21 2026