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.

Error code	Status	Description
-1	Success	The operation has completed successfully.
0	FeesExceedAmount	Total fees are higher than the payment amount.
1	NewPayee	Payee was created without payment details. Add payment details to continue.
2	ProviderRejectedPOErrorCode	Payment was rejected by the payment provider.
3	NoPM	No payment method was selected for this payment.
4	AddressMissing	Payee address is missing.
5	TaxFormsMissing	Required tax forms were not provided.
6	PMNotSupported	The selected payment method is not supported.
7	NoUpdateSinceLastTransactionFailed	Payment was deferred because a previous payment with the same details was rejected. Update the payment details and submit again.
8	HoldPayments	Payee selected “Hold my payments”, so this payment cannot be sent.
9	MissingRefCode	Ref Code is missing. This field is required.
10	ComplianceReview	Payee is pending compliance review.
11	IdapContainsSpaces	IDAP value cannot contain spaces before or after the value.
12	MissingInfo	Payee selected PayPal but does not have a valid PayPal email address.
13	IdapContainsIllegalCharacters	IDAP value contains invalid characters. Special characters and spaces are not allowed.
14	TaxNumberMissing	Tax ID number is missing.
15	VatNumberMissing	VAT number is missing.
16	TaxFormNotValid	Tax form did not pass validation. Ask the payee to review and upload it again.
17	WithholdingRateLimitReached	{0} has reached the limit defined by the {1} tax treaty. You may need to apply withholding on previous payments made during this tax year totaling USD {2}.
18	IdapMaxLengthExceeded	IDAP value exceeds the maximum length of 64 characters.
19	VatValidationFailed	Payee did not pass VAT validation.
20	CustomFieldValueIsNotUnique	Custom field value must be unique.
21	AmountBelowThreshold	Payment amount is below the minimum allowed amount ({0}{1}).
22	AmountAboveThreshold	Payment amount exceeds the maximum allowed amount ({0}{1}).
23	BelowPersonalThreshold	Payment amount is below the minimum threshold defined by the payee.
24	BelowPayerThresholdForPM	Payment amount is below the minimum threshold for this payment method.
25	AmountExceedsPayerMax	Payment amount exceeds the payer account configured limit. Contact Tipalti Support if you need to increase this limit.
26	AmountExceedsPMMax	Payment amount exceeds the maximum allowed for this payment method. Contact your support team.
27	DuplicatePayee	Duplicate payee with similar Ref Codes in the payment batch. Make sure Ref Codes are unique.
28	AccountRequiresFunding	Payer account does not have enough funds.
29	SupportReviewRequired	This payment requires review by Tipalti Operations.
30	DuplicateRefCode	Ref Code is not unique and was already used for a previous payment.
31	RefCodeLengthError	Ref Code exceeds the maximum length of {0} characters.
32	BadPaymentAmount	Invalid payment amount. Value must be positive and at least 0.01.
33	ParseError	Line could not be processed. The file contains an invalid value for {column}: {value}.
34	PendingOFACInfo	Additional payee information is required to complete compliance screening.
35	PayeeIsBlockedByProvider	Payee is blocked by Tipalti.
36	IllegalCharacterInRefCode	Ref Code contains invalid characters. Only hyphens and underscores are allowed.
37	RefCodeShouldNotBeEmpty	Ref Code cannot be empty.
38	PaymentOrderSubmissionFailed	Payment could not be submitted.
39	CurrencyIsNotSupportedByTipalti	Currency is not supported by Tipalti.
40	CurrencyIsNotSupportedByPayer	Currency is not supported by the payer.
41	PayeeCurrencyIsNotProvided	Payment currency was not selected.
42	PaypalNotSupportCurrency	Currency is not supported for PayPal payments.
43	MultiplePayeeWithSameIdap	More than 1 payee has this IDAP in the system. Contact Tipalti Support.
44	IdapIsNull	IDAP value is missing.
45	PayerNotSupportsScheduling	Payment scheduling is not supported for this payer. Contact Tipalti Support to enable this feature or remove the scheduled date.
46	AllowEarlyPayIsTrueWhileScheduledDateNotProvided	Early payment is enabled but no scheduled payment date was provided.
47	POCurrencyDontMatchToAnyLoanerCurrency	Payment currency does not match any loan provider currency configured for this payer.
48	PayerNotSupportsEarlyPayment	Early payments are not supported for this payer.
49	EarlyPaymentCannotBePaidViaChosenPaymentMethod	Early payments cannot be processed with the selected payment method.
50	PayerTermsOfUseNotApproved	Payer terms of use have not been approved.
51	TipaltiTermsOfUseNotApproved	Tipalti terms of use have not been accepted.
52	PayeeIsBlocked	Payee is blocked and cannot receive payments.
53	FailedFraudReview	Payee did not pass fraud review and is under risk review.
54	PayeeAccountIsClosed	Payee account is closed.
55	FailedInternalReviewPayee	Payee did not pass internal review.
56	FailedInternalReviewPayeeWithHiddenReason	Payee did not pass internal review.
57	FailedInternalReviewPayer	Payer did not pass internal review.
58	NoDocsProvided	Required setup documents were not provided.
59	SetupDocumentsNotUploaded	Required setup documents were not uploaded.
60	SetupDocumentRejected	The uploaded {0} document was rejected. The payee must upload a new document.
61	SetupDocumentPendingReview	The {0} document was uploaded by the payee but has not been reviewed yet.
62	IntercashCurrencyIsNotSupported	Payment currency is not supported by the Intercash account.
63	NoPhysicalAccountFoundForMoneyTransmiter	No physical account was found for the money transmitter.
64	NoPhysicalAccountRoutingFoundForMoneyTransmiter	No physical account routing was found for the money transmitter.
65	NoPaymentRouting	No payment routing was found for this payment.
66	DueDateTooFar	Scheduled payment date is more than 6 months in the future and cannot be submitted.
67	PayeeIsSuspended	Payee is suspended and cannot receive payments.
68	PendingFundingPoManuallyDeferred	Payment was manually deferred due to pending funding for early payments.
69	UnSupportedCountry	{0} is not supported in {1}.
70	UnSupportedCurrency	Currency {0} is not supported when using {1}.
71	TaxDocumentsNotUploaded	Tax documents were not uploaded by the payee.
72	TaxDocumentRejected	The uploaded tax document was rejected. The payee must upload a new document.
73	TaxDocumentPendingReview	The payee tax document has not been reviewed yet.
74	MaxWithholdingTypeInvalidValue	Maximum withholding value is invalid.
75	InvalidIncomeType	Income type is invalid.
76	IncomeTypeNotSupportedByPayer	Income type {0} is not mapped to your account. Add it to your account or select a different income type.
77	NoDefaultIncomeTypeForPayer	No default income type is configured for this account. Contact Tipalti Support.
78	TaxDocumentManualPendingReview	The payee tax form is pending manual review.
79	TaxDocumentExplanationRejected	The explanation for the tax document was rejected.
80	TinValidationNotsupported	TIN validation is not supported. Contact Tipalti Support to enable TIN validation or remove the value.
81	NoUsCertificateExpired	The “No US activities” certificate has expired.
82	PayeeReviewPending	Payee record is pending review.
83	PayeeReviewDeclined	Payee profile was reviewed and declined.
84	PayeeReviewUpdateRequested	Payee record requires an update.
85	PendingComplianceReview	Payee is pending compliance review.
86	NoDocsProvidedForComplianceReview	No documents were provided for compliance review.
87	BillAmountInvalid	Payment amount must be at least 0.01.
88	AdditionalWithholdingRateInputInvalid	Additional withholding value is invalid. Use decimal numbers, with or without a percentage sign.
89	TotalWithholdingRateInvalid	Total withholding must be less than 100% of the payment. For this payment, federal withholding = {0} and {1} withholding = {2}.
90	FailedCalculatingEarlyPaymentFees	Early payment fees could not be calculated for this payment.
91	LoanProviderNotFoundForPayer	Loan provider was not found for this payer.
92	RoutingNotProducedVirtualAccountForLoanProviderPayer	No virtual account was created for the loan provider payer.
93	CouldNotFindRoutingForLoanProviderPayer	No routing could be found for the loan provider payer.
94	EarlyPaymentDoesNotHaveOriginalAccountInformation	NetNow payment does not have original account information. The payment order for NetNow cannot be processed.
95	LoanProviderMissingFunds	Loan provider does not have enough funds for early payments.
96	OnlyVendorCreditsWereSelected	Only vendor credits were selected for this payee.
97	BankIsOnInternationalSanctionsList	Bank is on an international sanctions list.
98	PayeeBlockedByCompliance	Payee is blocked by compliance.
99	BillIsMarkedAsPotentialDuplicate	Bill is marked as a potential duplicate.
100	AutoResolvePaymentsCanceledByTipalti	Auto-resolve: payment was canceled by Tipalti.
101	BillIsMarkedAsHoldPayment	Bill is marked as “Hold payment” by {0} on {1}.
102	UsSourceInputFormatNotValid	US source value is invalid. Enter a number between 0 and 100.
103	UsSourceValueCantSetForOtherIncomeType	US-sourced payment value cannot be set for income type “OtherIncome”.
104	UsSourceSetForPayeeAndPayerWithInvalidTaxSetting	US-sourced payment value cannot be set for this payee because the tax settings or tax forms are not valid.
105	PayerEntityCountryCantPayToPayeeCountry	This payer entity cannot send payments to the payee country.
106	PayerEntityDoesNotExist	Payer entity does not exist.
107	TaxEnabledForDifferentDefaultAndPayingPayerEntity	Tax configuration is inconsistent between the default payer entity and the paying payer entity. Align tax settings or use a single payer entity for this payment.
108	PayeeVerificationFailed	Payee did not pass verification.
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	The reference code is too long. ASCII: max. length = 16 (Account Direction model: max. length = 15)
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	The reference code contains illegal characters. Valid special characters: hyphens, underscores
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: Advise the payee to log into the iFrame or Supplier Hub and update the payment currency. Log into the Supplier Hub as the payee and update the payment currency.
10115	PaypalNotSupportCurrency	PayPal does not support the selected currency. Only applies if the payer is using its own physical PayPal account for payments
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.

ZD.4.log-1212665864.zip
20 KB Download

Articles in this section

Payment error codes