Payment error codes
Payment error codes may be encountered when submitting payment instructions to Tipalti. All payment error codes affect processing of an individual payment, except for those labeled "Payment batch cannot be processed". In such cases, the entire payment batch fails. The following is a list of error codes, status, and descriptions.
LEGEND | |
---|---|
Triggers an email to the payee | |
Payee can see this error in the iFrame or Supplier Hub |
|
Payment batch cannot be processed |
error code |
status |
description |
|||
---|---|---|---|---|---|
-1 | Success | The operation has completed successfully. | |||
0 | FeesExceedAmount | The fees exceed the amount to be paid to the payee (this amount must be positive after fees have been deducted). | |||
1 | NewPayee | The payee is a new payee and no payment-related details have been provided. Please advise the payee to log into the iFrame or Supplier Hub and complete the payment details in order to be considered "payable" by the Tipalti system. | |||
2 | ProviderRejectedPO ErrorCode |
The provider rejected the payment. Tipalti has already notified you of the rejected payment. | |||
3 | NoPM |
The payee has not selected a payment method. You can:
|
|||
4 | AddressMissing |
The payee address has not been provided. You can:
|
|||
5 | TaxFormsMissing | The payee has not provided the required tax forms. Please advise the payee to log into the iFrame or Supplier Hub and complete the Tax forms page of the "Payment details" tab. | |||
6 | PMNotSupported |
The payment method selected by the payee is not supported. You can:
|
|||
7 | NoUpdateSinceLast TransactionFailed |
The last payment transaction to the payee failed and since then, the payee has not updated the payment information. You can:
|
|||
8 | HoldPayments | The payee has selected "Hold my payments" in the iFrame or Supplier Hub. No disbursement can be made until the payee changes this selection. | |||
9 | MissingRefCode | The reference code is missing. This field is mandatory. | |||
10 | ComplianceReview | This transaction is under compliance review. Please submit a ticket to our Support Team to get further information. | |||
11 | IdapContainsSpaces | The payee ID cannot contain leading or trailing spaces. Please check the Idap value. | |||
10001 | BelowPersonalThreshold | The amount is below the threshold that has been defined by the payee (see Payment threshold). The payee can be paid in the next payment cycle (see What to do with deferred payments). | |||
10002 | BelowPayerThreshold ForPM |
The amount is below the threshold that has been defined by the payer for this payment method (see Payment threshold). The payee can be paid in the next payment cycle (see What to do with deferred payments). | |||
10003 | AmountExceedsPayerMax | The amount exceeds the payer's set maximum. Please contact your Support Team. | |||
10004 | AmountExceedsPMMax | The amount exceeds the payment method maximum (see Payment methods). Please contact your Support Team. | |||
10005 | DuplicatePayee | A duplicate payee is in the file. | |||
10006 | AccountRequiresFunding | There are insufficient funds in the payer account to pay all payments. Please add funds to your provider accounts. | |||
10007 | SupportReviewRequired | Your support team is required to review the payment, as your payment cycle includes payer approval of payment instructions. | |||
10008 | DuplicateRefCode | The reference code is not unique within the payment instructions or it has been used in a prior payment. | |||
10009 | RefCodeLengthError |
|
|||
10010 | BadPaymentAmount | An invalid payment amount is in the file. The payment amount must be positive and cannot contain amounts below one cent. | |||
10011 | ParseError | The system failed to parse the line, as the file contains incorrect formats. | |||
10012 | PendingOFACInfo | Additional payee information is pending for compliance; the payee is unpayable. | |||
10013 | BlockedOFACInfo | Compliance investigation of the payee is still in progress since the last payment attempt; the payee is unpayable. | |||
10014 | IllegalCharacterInRefCode |
|
|||
10111 | CurrencyIsNotSupported ByTipalti |
Tipalti does not support the selected currency. | |||
10112 | CurrencyIsNotSupported ByPayer |
The payer does not support the selected currency. | |||
10113 | AccountRequiresFunding ForFees |
The payer account requires funding for fees. Please add funds to your provider accounts. | |||
10114 | PayeeCurrencyIsNotProvided |
The payee payment currency has not been provided. You can:
|
|||
10115 | PaypalNotSupportCurrency |
|
|||
10116 | MultiplePayeeWithSameIdap | Multiple payees have the same payee ID. The payee ID must be unique for each payee. | |||
10117 | IdapIsNull | Payee ID is missing. | |||
10118 | PayerNotSupportsScheduling | The payer does not support payment scheduling (i.e., this feature has not been activated in Tipalti). Please submit a request to our Support Team to activate this feature. | |||
10120 | POCurrencyDontMatch ToAnyLoanerCurrency |
Loan providers do not support the selected payment order currency. Please change the payment currency. | |||
101083 | deferredInternal | Payments from your company's country to the payee's country are not supported. The existing payment order cannot be changed. |