Navigate to...

Error Codes

Semantic Validation

All the attributes in Visa Direct Connect will go through the schematic validation e.g., mandatory information is missing.

Business Validation

All the attributes in Visa Direct Connect will go through the data content validations e.g., duplicate check.

Response schema with key attributes

In the response, the following attributes are required to be displayed:

status: http status code-4XX, 5XX

reason: Most common example is "InvalidPayoutRequest"

details:

Location when known when it is not known value is "Undefined”.
Message: As defined in messages in the next section.
Code: As defined in scenarios in the next section.

Error Codes - Visa Direct for Account and Wallet only

Below are Payout Request errors and the corresponding error codes for Visa Direct Connect transactions for Visa Direct for Account programs.

HTTP Error Code	Error Code	Error Message	Recommended Handling
400	4003	The recipient country and currency route selected is not supported.	Ensure the recipient country and currency route selected are supported and re-submit.
400	4004	The recipient country and currency route selected is not supported.	Ensure the highlighted field has the correct length value and re-submit.
400	4100	Transaction cannot be processed at this time, please contact Visa.	Contact your Visa production support contact for investigation and assistance.
400	4102	The recipient bank account is not supported.	Ensure the recipient bank account is valid and re-submit.
400	4110	The beneficiary Bank Account Intermediary Account supplied field contains not supported characters.	Ensure beneficiary Bank Account Intermediary Account supplied field contains supported set of characters and re-submit.
400	4111	Route not supported, please contact Visa representative.	Contact your Visa production support contact for investigation and assistance.
400	4203	Sender or recipient identification type is required.	Ensure the Sender or recipient identification type provided and re-submit.
400	4205	Sender or recipient identification number is not numeric.	Ensure the Sender or recipient identification number is correct and re-submit.
400	4208	Sender or recipient country in address is not allowed.	Ensure the Sender or recipient country in address is allowed and re-submit.
400	4209	Sender or recipient identity issue country is not allowed.	Ensure the Sender or recipient identity issue country in address is allowed and re-submit.
400	4215	Sender or recipient identity number is not binary.	Ensure the Sender or recipient identity number is correct and re-submit.
400	4218	Sender or recipient identity number is not numeric.	Ensure the Sender or recipient identity number is correct and re-submit.
400	4220	Only one document number must be supplied for sender or recipient.	Ensure the Sender or recipient identity number is correct and re-submit.
400	4221	The recipient identification information is invalid or missing.	Ensure the recipient identification information must be provided and valid then re-submit.
400	4223	Sender or recipient additional identity data contains more than one item of the same name.	Ensure Sender or recipient additional identity data shouldn't contain more than one item of the same name and re-submit.
400	4225	Value contains non-supported characters.	Ensure the given value should support given set of characters and re-submit.
400	4227	Sender or recipient details exceeds max length.	Ensure the Sender or recipient details doesn't exceed max length and re-submit.
400	4300	Sender or recipient detail data is incomplete.	Ensure the Sender or recipient details should be complete and re-submit.
400	4302	Additional data is required for this purpose of payment.	Ensure the additional data must be provided for given purpose of payment and re-submit.
400	4401	Recipient bank account has duplicate data.	Remove the duplicate data value and re-submit.
400	4403	Payout request has an illegal character data.	Ensure the payout request must contains legal character data and re-submit.
400	4404	The recipient bank account is inactive.	Ensure the recipient bank account is active and re-submit.
400	4407	Payout is not cancellable.	No action required
400	4408	Payout is pending cancellation.	Wait for next payout status notification for confirm the cancellation state
400	4409	Transaction cannot be processed at this time, please contact Visa.	Contact your Visa production support contact for investigation and assistance.
400	4600	Final state of the transaction is unknown.	Wait for next payout status notification for the next transaction state
400	4601	Validation failed for Retrieval Reference Number. This transaction can no longer be retried.	No action required
400	4602	Transaction currency is not same as Destination currency.	Ensure the Transaction currency must be same as Destination currency and re-submit.
400	4603	Payout not cancellable.	No action required
400	4604	Transaction currency did not match the settlement currency or the destination currency.	Ensure the Transaction currency must match the settlement currency or the destination currency and re-submit.
400	4700	This payout request matches with other payout transactions which are in an inconsistent state. Please contact your Visa Representative.	Contact your Visa production support contact for investigation and assistance.
400	4701	This payout request is inconsistent with the previously processed payout transaction.	No action required
400	4702	The payout transaction that has been queried is in an inconsistent/unknown state.	No action required
400	4703	The payout transaction is in an inconsistent state. Please contact your Visa Representative.	Contact your Visa production support contact for investigation and assistance.
400	4704	Payout not cancellable at this time. Payout is in an inconsistent state.	No action required
400	4900	Current transaction is a duplicate. Original Payout attempt is in ERROR. Please contact a Visa representative.	Contact your Visa production support contact for investigation and assistance.
400	4901	Current transaction is a duplicate. Original Payout attempt is in an undefined state. Please contact a Visa representative.	Contact your Visa production support contact for investigation and assistance.
400	4902	Current transaction is a duplicate. Original Payout attempt terminated unsuccessfully.	Ensure the transaction shouldn't be duplicate and re-submit.
400	5000	This payout request is inconsistent with the previously processed payout transaction.	Ensure the transaction shouldn't be inconsistent and re-submit.
400	5100	Request is forbidden.	Contact your Visa production support contact for investigation and assistance.
400	5101	Current transaction is a duplicate. Original Payout was attempted on different API or API version.	Ensure the transaction shouldn't be duplicate and re-submit.
400	5102	Current transaction is a duplicate.	Ensure the transaction shouldn't be duplicate and re-submit.
400	5200	Payout attempt terminated unsuccessfully.	No action required
400	5201	Payout in queue. Wait for the status notification and retry cancellation later.	Wait for next payout status notification for the next transaction state
400	5300	This transaction has already been cancelled. Current request is a duplicate.	No action required
400	5301	Transaction not in a cancellable state.	No action required
400	11000	Mandatory value is missing.	Input mandatory value and re-submit.
400	11001	The insufficient bank data supplied. Please contact customer support for more info.	Contact your Visa production support contact for investigation and assistance.
400	11002	The recipient bank BIC is not found.	Ensure the recipient bank BIC must be provided and re-submit.
400	11003	The recipient companyName or firstName + lastName combination or fullName is required.	Ensure the recipient companyName or firstName + lastName combination or fullName is required and re-submit.
400	11004	Only recipient companyName or firstName + lastName combination or fullName is allowed.	Ensure the recipient companyName or firstName + lastName combination or fullName is required and re-submit.
400	11005	The recipient companyName or fullName is mandatory.	Ensure the recipient companyName or fullName must be provided and re-submit.
400	11006	Only recipient companyName or fullName is allowed.	Ensure the recipient companyName or fullName must be provided and re-submit.
400	11007	The recipient firstName + lastName combination or fullName is required.	Ensure the recipient companyName or fullName must be provided and re-submit.
400	11008	Only recipient firstName + lastName combination or fullName is allowed.	Ensure the recipient companyName or fullName must be provided and re-submit.
400	11052	Value provided for one of the fields is too long.	Ensure the highlighted field has the correct length value and re-submit.
400	11053	Value provided for one of the fields is too short.	Ensure the highlighted field has the correct length value and re-submit.
400	11054	Value provided for one of the fields has incorrect format	Ensure the highlighted field has the valid value and re-submit.
400	11055	Value provided for one of the fields is invalid.	Ensure the highlighted field has the valid value and re-submit.
400	11057	The recipient bank information is not sufficient.	Ensure the recipient bank information must be sufficient and re-submit.
400	11156	The recipient bank code should not be supplied for this territory.	Ensure the recipient bank code is correct for the given territory and re-submit.
400	11157	The recipient bank code is contradicting.	Ensure the recipient bank code is correct for the given territory and re-submit.
400	11159	The recipient bank code contradicts the supplied account number.	Ensure the recipient bank code is correct for the given territory and re-submit.
400	11160	The recipient bank sort code contains non-numeric characters.	Ensure the recipient bank sort code must be present with the correct value and re-submit.
400	11161	The recipient bank sort code contains non-alphanumeric characters.	Ensure the recipient bank sort code must be present with the correct value and re-submit.
400	11162	The recipient bank sort code is required.	Ensure the recipient bank sort code must be present with the correct value and re-submit.
400	11163	The recipient bank sort code is not eligible for local schemes.	Ensure the recipient bank sort code must be eligible for local schemes and re-submit.
400	11170	The recipient bank ABA routing number is required.	Ensure the recipient bank ABA routing number must be present with the correct value and re-submit.
400	11171	The recipient bank ABA routing number contradicts the one derived from this account.	Ensure the recipient bank ABA routing number must be present with the correct value and re-submit.
400	11172	The recipient bank code is not found on CB.Net lookup.	Ensure the recipient bank sort code must be present with the correct value and re-submit.
400	11173	ABA routing number and a Fedwire code have been supplied which contradict each other.	Ensure the ABA routing number and a Fedwire code must be present with the correct value and re-submit.
400	11202	The recipient bank branch code is required in the territory.	Ensure the recipient bank branch code must be present for given territory with the correct value and re-submit.
400	11205	The recipient bank branch code should not be supplied for this territory.	Ensure the recipient bank branch code must be present for given territory with the correct value and re-submit.
400	11206	The recipient bank branch code is contradicting.	Ensure the recipient bank branch code must be present for given territory with the correct value and re-submit.
400	11208	The recipient bank branch code not found on CB.Net lookup.	Ensure the recipient bank branch code must be present for given territory with the correct value and re-submit.
400	11360	The recipient bank account number failed modulus check.	Ensure the recipient bank account number value is correct and re-submit.
400	11364	The recipient bank account IBAN is required in the territory.	Ensure the recipient bank account IBAN must be present for given territory with the correct value and re-submit.
400	11367	The recipient bank account IBAN country is not recognized.	Ensure the recipient bank account IBAN must be present for given territory with the correct value and re-submit.
400	11368	The recipient bank account IBAN failed modulus check.	Ensure the recipient bank account IBAN must be present for given territory with the correct value and re-submit.
400	11370	The recipient bank account IBAN is contradicting.	Ensure the recipient bank account IBAN must be present for given territory with the correct value and re-submit.
400	11371	The recipient bank account IBAN contradicts the supplied routing number.	Ensure the recipient bank account IBAN must be present for given territory with the correct value and re-submit.
400	11372	The recipient bank account IBAN contradicts the supplied account number.	Ensure the recipient bank account IBAN must be present for given territory with the correct value and re-submit.
400	11374	The recipient bank IBAN contradicts account number suffix.	Ensure the recipient bank account IBAN must be present for given territory with the correct value and re-submit.
400	11375	The recipient bank Account Number and Sort Code mismatch.	Ensure the recipient bank Account Number and Sort Code are correct values and re-submit.
400	11376	The recipient bank account IBAN supplied implies a country different than the country code supplied.	Ensure the recipient bank account IBAN must be present for given territory with the correct value and re-submit.
400	11401	The recipient bank account type is required in the territory.	Ensure the recipient bank account type must be present for given territory with the correct value and re-submit.
400	11452	The recipient bank account number suffix is required in the territory.	Ensure the recipient bank account number suffix must be present for given territory with the correct value and re-submit.
400	11501	The recipient bank BIC code contradicts with bank code.	Ensure the recipient bank BIC code and bank code are valid and re-submit.
400	11502	The recipient bank BIC country does not match bank account country.	Ensure the recipient bank BIC country code and bank code are valid and re-submit.
400	11505	The recipient bank BIC does not exist in bank partner reference table.	Ensure the recipient bank BIC does exist in bank partner reference table with the valid value and re-submit.
400	11506	The recipient bank BIC supplied contradicts the bank identified by the supplied bank code.	Ensure the recipient bank BIC supplied with the correct value for the bank identified by the supplied bank code and re-submit.
400	11507	The recipient bank BIC has not been supplied and is required in the territory.	Ensure the recipient bank BIC must be present for given territory with the correct value and re-submit.
400	11508	The recipient bank BIC contains non-alphanumeric characters.	Ensure the recipient bank BIC must be present for given territory with the correct value and re-submit.
400	11509	The recipient bank BIC country does not match the SWIFT BIC country.	Ensure the recipient bank BIC must be present for given territory with the correct value and re-submit.
400	11510	The recipient bank BIC is not supported.	Ensure the recipient bank BIC must be present for given territory with the correct value and re-submit.
400	11551	At least one recipient additional data item must be supplied.	Ensure at least one recipient additional data item must be supplied and re-submit.
400	11653	The recipient additional data key is not known.	Ensure the recipient additional data key value is valid and re-submit.
400	11750	The recipient identificationList must be provided.	Ensure the recipient identificationList must be provided and re-submit.
400	11900	The recipient alias must be null.	Ensure the recipient alias must not be null and re-submit.
400	11950	The recipient payoutMethod must not be null.	Ensure the recipient payoutMethod must not be null and re-submit.
400	11952	The recipient payout method is not supported.	Ensure the recipient payoutMethod is supported and re-submit.
400	12003	Conflicting recipient name, identity or type.	Ensure the recipient name, identity or type must be aligned and re-submit.
400	12004	Identity Type of beneficiary is required.	Ensure the Identity Type of beneficiary is required and re-submit.
400	12050	The recipient card must be null.	Ensure the recipient card must not be null and re-submit.
400	13250	No eligible routes found which allow payer unstructured identity.	Ensure that no eligible routes found which allow payer unstructured identity and re-submit.
400	13357	The recipient name or firstName + lastName combination is required.	Ensure the recipient name or firstName + lastName combination is required and re-submit.
400	13358	Only recipient name or firstName + lastName combination is allowed.	Ensure the recipient name or firstName + lastName combination is allowed and re-submit.
400	13359	The recipient name is mandatory.	Ensure the recipient name is mandatory and re-submit.
400	13360	Only recipient name is allowed.	Ensure only recipient name is allowed and re-submit.
400	13361	The recipient firstName + lastName combination or name is required.	Ensure the recipient firstName + lastName combination or name is required and re-submit.
400	13362	Only recipient firstName + lastName combination or name is allowed.	Ensure the recipient firstName + lastName combination or name is allowed and re-submit.
400	13380	The recipient middleName must be null.	Ensure the recipient middleName must be null and re-submit.
400	13425	The recipient bank must be null.	Ensure the recipient bank must be null and re-submit.
400	13426	Recipient wallet must be null.	Ensure the recipient wallet must be null and re-submit.
400	13500	The recipientDetail address streetName must be null.	n/a
400	13550	The recipientDetail address streetName must be null.	Ensure the recipientDetail address streetName must be null and re-submit.
400	13600	The recipientDetail address minorSubDivisionCode must be null.	Ensure the recipientDetail address minorSubDivisionCode must be null and re-submit.
400	13701	The recipient identification idOwnerType must be null.	Ensure the recipient identification idOwnerType must be null and re-submit.
400	22203	The recipient middleName must be null.	Ensure the recipient middleName must be null and re-submit.
400	31251	The transactionDetail transactionCurrencyCode must be a numeric of length 3.	Ensure the transactionDetail transactionCurrencyCode must be a numeric of length 3 and re-submit.
400	31303	Payment amount exceeds the route limit.	Ensure the payment amount does not exceeds the route limit and re-submit.
400	31550	Transaction purpose of payment is required.	Ensure the transaction purpose of payment is required and re-submit.
400	31658	The transaction endToEndId must not be null.	Ensure the transaction endToEndId must not be null and re-submit.
400	41001	Sender companyName or fullName is required.	Ensure the sender companyName or fullName is allowed and re-submit.
400	41002	Only sender companyName or fullName is allowed.	Ensure the sender companyName or fullName is allowed and re-submit.
400	41003	The sender firstName + lastName combination or fullName is required.	Ensure the sender firstName + lastName combination or fullName is allowed and re-submit.
400	41004	Only sender firstName + lastName combination or fullName is allowed.	Ensure the sender firstName + lastName combination or fullName is allowed and re-submit.
400	41005	The senderAccountNumber or senderReferenceNumber is required.	Ensure the senderAccountNumber or senderReferenceNumber is allowed and re-submit.
400	41006	Only senderAccountNumber or senderReferenceNumber is allowed.	Ensure the senderAccountNumber or senderReferenceNumber is allowed and re-submit.
400	41007	Sender name is required.	Ensure the sender name is required and re-submit.
400	41008	Only sender name is allowed.	Ensure the sender name is allowed and re-submit.
400	41009	Sender firstName + lastName combination or name is required.	Ensure the sender firstName + lastName combination is allowed and re-submit.
400	41010	Only sender firstName + lastName combination or name is allowed.	Ensure the sender firstName + lastName combination is allowed and re-submit.
400	41011	The sender name or firstName + lastName combination is required.	Ensure the sender name or firstName + lastName combination is allowed and re-submit.
400	41012	Only sender name or firstName + lastName combination is allowed.	Ensure the sender name or firstName + lastName combination is allowed and re-submit.
400	41102	The senderReferenceNumber field must be null.	Ensure the senderReferenceNumber field must be null and re-submit.
400	41150	The sender sourceOfFunds field must be null.	Ensure the sender sourceOfFunds field must not be null and re-submit.
400	42400	No eligible routes found which allow payer unstructured identity.	Contact your Visa production support contact for investigation and assistance.
400	42620	The sender middleName must be null.	Ensure the sender middleName must not be null and re-submit.
400	42851	The sender identification idOwnerType must be null.	Ensure the sender identification idOwnerType must not be null and re-submit.
400	51001	Payout not found.	Ensure the payout details are correct and re-submit.
400	51013	StartDate cannot be after the endDate.	Ensure the StartDate cannot be after the endDate and re-submit.
400	51016	Date range should be less than or equal to 7 days.	Ensure the Date range should be less than or equal to 7 days and re-submit.
400	51021	The idType must be one of CLIENT_REFERENCE_ID or PAYOUT_ID.	Ensure the Id type must be set as 'Client_Reference_Id' or 'Payout_Id' and re-submit.
400	51204	The sender middleName must be null.	Ensure the sender middleName must not be null and re-submit.
400	52010	Insufficient fund in merchant account.	Ensure the funds are available in merchant account and re-submit.
400	52012	Expired transfer proposal.	Contact your Visa production support contact for investigation and assistance.
400	53000	Transaction Error.	Ensure the transaction details are correct and re-submit.
400	53003	Partner corridor not active.	Contact your Visa production support contact for investigation and assistance.
400	53008	Subscriber not found.	Contact your Visa production support contact for investigation and assistance.
400	53009	Subscriber not authorized to receive amount.	Contact your Visa production support contact for investigation and assistance.
400	53011	Transaction could not be executed.	Contact your Visa production support contact for investigation and assistance.
400	53013	E-wallet system error.	Contact your Visa production support contact for investigation and assistance.
400	53014	MFS system error.	Contact your Visa production support contact for investigation and assistance.
400	53015	Blacklist error.	Contact your Visa production support contact for investigation and assistance.
400	53016	Daily sender velocity limit exceeded.	Ensure the daily sender velocity limit must not be exceeded before re-submit.
400	53017	Daily recipient velocity limit exceeded.	Ensure the daily recipient velocity limit must not be exceeded before re-submit.
400	53018	Weekly sender velocity limit exceeded.	Ensure the weekly sender velocity limit must not be exceeded before re-submit.
400	53019	Weekly recipient velocity limit exceeded.	Ensure the weekly recipient velocity limit must not be exceeded before re-submit.
400	53020	Monthly sender velocity limit exceeded.	Ensure the monthly sender velocity limit must not be exceeded before re-submit.
400	53021	Monthly recipient velocity limit exceeded.	Ensure the monthly recipient velocity limit must not be exceeded before re-submit.
400	53022	Transaction max amount exceeded.	Ensure the transaction max amount must not be exceeded before re-submit.
400	53023	Subscriber not authorized to receive transaction.	Contact your Visa production support contact for investigation and assistance.
400	53050	The payoutMethod must not be null.	Ensure to payoutMethod must be present with the correct value and re-submit.
400	54450	The number of calendar days requested must be an integer value between 1 and 30.	Ensure to number of calendar days requested with the correct value and re-submit.
400	61000	Unknown query parameter.	Contact your Visa production support contact for investigation and assistance.
400	61000	Unknown query parameter.	n/a
400	61000	Unknown query parameter.	n/a
400	61204	The sourceCurrencyCode should not be supplied for Push to Account.	Ensure to remove the sourceCurrencyCode for Push to Account and re-submit.
400	61205	The sourceAmount should not be supplied for Push to Account.	Ensure to remove the sourceCurrencyCode for Push to Account and re-submit.
400	61250	The transactionDetail sourceCurrencyCode must be null.	Ensure the transactionDetail sourceCurrencyCode must be valid and re-submit.
400	61300	The transactionDetail sourceAmount must be null.	Ensure the transactionDetail sourceAmount must be valid and re-submit.
400	70102	The currencyCode must be an alphabetic string length of three characters.	Ensure the transaction currency code inside transaction details must be correct length and re-submit.
400	100050	The minor units in Transaction Amount does not align with currency exponent.	Ensure the minor units in Transaction Amount must be align with currency exponent and re-submit.
400	100949	The length of the field is incorrect.	Ensure the length of the field is correct before re-submit.
400	502150	The recipient card paymentCredentialReference must be null.	Ensure the recipient card paymentCredentialReference must be provided and valid before re-submit.
400	502450	The senderDetail paymentCredentialReference must be null.	Ensure the senderDetail paymentCredentialReference must be provided and valid before re-submit.
400	504102	The transactionDetail secondaryId must be null.	Ensure the transactionDetail secondaryId must be provided and valid before re-submit.

Error Codes – Visa Direct for Card only

Below are Payout Request errors and the corresponding error codes for Visa Direct Connect transactions for Visa Direct for Card programs.

HTTP Error Code	Error Code	Error Message	Recommended Handling
400	11000	Mandatory value is missing.	Input mandatory value and re-submit.
400	11052	Value provided for one of the fields is too long.	Ensure the highlighted field has the correct length value and re-submit.
400	11053	Value provided for one of the fields is too short.	Ensure the highlighted field has the correct length value and re-submit.
400	11055	Value provided for one of the fields is invalid.	Ensure the highlighted field has the valid value and re-submit.
400	13426	One or more fields don't match the payoutMethod provided.	Ensure the given fields match with the payoutMethod and re-submit.
400	100050	The minor units in Transaction Amount does not align with currency exponent.	Ensure the minor units in Transaction Amount must align with currency exponent and re-submit.
400	31251	The transactionDetail transactionCurrencyCode must be a numeric of length 3.	Ensure the transaction currency code inside transaction details must be correct length and re-submit.
400	13357	The recipient name or firstName + lastName combination is required.	Ensure the recipient name or firstName + lastName combination are correctly provided and re-submit.
400	13358	Only the recipient name or firstName + lastName combination is allowed	Ensure the recipient name or firstName + lastName combination are correctly provided and re-submit.
400	13359	The recipient name is mandatory	Ensure the recipient name must be provided and re-submit.
400	13360	Only the recipient name is allowed	Ensure the recipient name must be provided and re-submit.
400	13361	The recipient firstName + lastName combination or name is required	Ensure the recipient name or firstName + lastName combination are correctly provided and re-submit.
400	13362	Only recipient firstName + lastName combination or name is allowed	Ensure the recipient name or firstName + lastName combination are correctly provided and re-submit.
400	41102	The senderReferenceNumber field must be null	Ensure the sender reference number must be null and re-submit.
400	41005	The senderAccountNumber or senderReferenceNumber is required.	Ensure the senderAccountNumber or senderReferenceNumber must be provided and re-submit.
400	41007	Sender name is required.	Ensure the sender name must be provided and re-submit.
400	41008	Only sender name is allowed.	Ensure the sender name must be provided and re-submit.
400	41009	Sender firstName + lastName combination or name is required.	Ensure the sender name or firstName + lastName combination are correctly provided and re-submit.
400	41010	Only sender firstName + lastName combination or name is allowed.	Ensure the sender name or firstName + lastName combination are correctly provided and re-submit.
400	41011	The sender name or firstName + lastName combination is required.	Ensure the sender name or firstName + lastName combination are correctly provided and re-submit.
400	41012	Only sender name or firstName + lastName combination is allowed.	Ensure the sender name or firstName + lastName combination are correctly provided and re-submit.
400	45001	API Internal Error: 1001. Please contact your Visa Representative.	API Internal Error: 1001. Please contact your Visa Representative.
400	45002	API Internal Error: 3001. Please contact your Visa Representative.	API Internal Error: 3001. Please contact your Visa Representative.
400	45003	API Internal Error: 1001. Please contact your Visa Representative.	API Internal Error: 1001. Please contact your Visa Representative.
400	45004	This payout request is inconsistent due to ClientReferenceID with the previously processed payout transaction	Ensure the ClientReferenceID value must be valid and re-submit.
400	45005	This payout request is inconsistent due to Card Account Number with the previously processed payout transaction.	Ensure the Card Account Number value must be valid and re-submit.
400	45006	This payout request is inconsistent due to Transaction Amount/Currency with the previously processed payout transaction.	Ensure the Transaction Amount/ Currency value must be valid and re-submit.
400	100915	Transaction amount exceeds the transaction limit.	Ensure the Transaction amount does not exceeds the limit before re-submit.
400	200915	Transaction frequency exceeds the limit.	Ensure the Transaction frequency does not exceeds the limit before re-submit.

Additional 400 Error Codes

Payin
Payout
AFTR
Adjustment
Query

HTTP Code	Thin Layer Error Code	Thin Layer Message	Description	Cause	Location
400	11000	Mandatory value is missing.	SourceCurrencyCode is missing	Source currency code missing when source amount provided	transactionDetail.additionalData.name[sourceCurrencyCode]
400	11000	Mandatory value is missing.	SourceAmount is missing	Source amount missing when source currency code provided	transactionDetail.additionalData.name[sourceAmount]
400	11000	Mandatory value is missing.	Field 'IrfType' is missing or has invalid content	Invalid Mexico IRF type value	transactionDetail.additionalData.value[n].mexicoNationalServiceData.irfType
400	11000	Mandatory value is missing.	Field 'AccountType' is missing or has invalid content	Invalid Mexico account type value	transactionDetail.additionalData.value[n].mexicoNationalServiceData.accountType
400	11000	Mandatory value is missing.	Field 'SenderPostalCode' is missing or has invalid content	Invalid sender postal code	senderDetail.address.postalCode
400	11000	Mandatory value is missing.	Field 'integratedCircuitCardData' is missing or has invalid content	Invalid integrated circuit card data format	recipientDetail.card.posData.integratedCircuitCardData
400	11057	Value is missing or has invalid content	Field 'recipientDateOfBirth' is missing or has invalid content	Invalid recipient date of birth format	recipientDetail.dateOfBirth
400	11055	Value provided for one of the fields is invalid.	Mandatory field 'AcquiringBin' is missing or has invalid content	Missing or invalid acquiring BIN	originatorDetail.acquiringBin
400	11055	Value provided for one of the fields is invalid.	Mandatory field 'AcquirerCountryCode' is missing or has invalid content	Missing or invalid acquirer country code	originatorDetail.acquiringCountryCode
400	11000	Mandatory value is missing.	merchantId value associated with Sender Token is missing or invalid	Invalid sender merchant ID for PCI token	senderDetail.paymentCredentialReference.merchantId
400	11000	Mandatory value is missing.	merchantId value associated with Recipient Token is missing or invalid	Invalid recipient merchant ID for PCI token	recipientDetail.paymentCredentialReference.merchantId
400	11054	Value provided for one of the fields has incorrect format	nationalReimbursementFee is not in the correct format to be transformed	Invalid decimal format for national reimbursement fee	transactionDetail.fees.nationalReimbursementFee
400	11054	Value provided for one of the fields has incorrect format	Amount is not in the correct format to be transformed	Invalid decimal format for various amount fields (surcharge misc amounts tax amounts)	transactionDetail.transactionAmount
400	11054	Value provided for one of the fields has incorrect format	SourceAmount is in the wrong format or has invalid minor digits	Source amount decimal places exceed currency minor unit	transactionDetail.additionalData.name[sourceAmount]
400	11054	Value provided for one of the fields has incorrect format	ReimbursementFee is not in the correct format to be transformed	Invalid Mexico reimbursement fee format	transactionDetail.additionalData.value[n].mexicoNationalServiceData.reimbursementFee
400	11054	Value provided for one of the fields has incorrect format	ReimbursementFeeTax is not in the correct format to be transformed	Invalid Mexico reimbursement fee tax format	transactionDetail.additionalData.value[n].mexicoNationalServiceData.reimbursementFeeTax
400	11055	Value provided for one of the fields is invalid.	Mandatory field 'RetrievalReferenceNumber' is missing or has invalid content	Invalid retrieval reference number format or date range (must be 1-366)	transactionDetail.clientReferenceId
400	11055	Value provided for one of the fields is invalid.	Mandatory field 'Amount' is missing or has invalid content	Invalid transaction amount format or amount not greater than surcharge	transactionDetail.transactionAmount
400	11055	Value provided for one of the fields is invalid.	Field 'SharingGroupCode' has invalid content	Invalid sharing group code characters	transactionDetail.routingNetworkId
400	11055	Value provided for one of the fields is invalid.	Mandatory field 'TransactionCurrency' is missing or has invalid content	Invalid or lowercase transaction currency code	transactionDetail.transactionCurrencyCode
400	11055	Value provided for one of the fields is invalid.	SourceCurrencyCode' does not exist	Invalid or non-existent source currency code	transactionDetail.additionalData.name[sourceCurrencyCode]
400	11055	Value provided for one of the fields has incorrect format	SourceAmount cannot be zero	Source amount is zero or negative	transactionDetail.additionalData.name[sourceAmount]
400	11055	Value provided for one of the fields is invalid.	Invalid country code	Invalid sender or recipient country code	recipientDetail.address.country
400	11055	Value provided for one of the fields is invalid.	Field has invalid content	Invalid cross-border country field values (senderNationality recipientNationality senderCountryOfBirth recipientCountryOfBirth)	Cross-border country field values (senderDetail.nationality recipientDetail.nationality senderDetail.countryOfBirth recipientDetail.countryOfBirth)
400	11055	Value provided for one of the fields is invalid.	Field 'visaMerchantIdentifier' has invalid content	Invalid visa merchant identifier format (non-numeric)	originatorDetail.cardAcceptor.visaMerchantIdentifier
400	11055	Value provided for one of the fields is invalid.	Invalid PAN	Invalid primary account number format	recipientDetail.card.AccountNumber
400	11055	Value provided for one of the fields is invalid.	Invalid Signature	Invalid signature verification failed	Unknown
400	11055	Value provided for one of the fields is invalid.	Invalid PAN or TOKEN	Invalid PAN or network token	recipient.card.primaryAccountNumber
400	11055	Value provided for one of the fields is invalid.	Invalid Account	Invalid account number	recipientDetail.card.accountNumber
400	11055	Value provided for one of the fields is invalid.	Mandatory field 'RetrievalReferenceNumber' is missing or has invalid content	Invalid retrieval reference number for deferred OCT queries/cancels	transactionDetails.clientReferenceId
400	11055	Value provided for one of the fields is invalid.	Invalid value for transactionStartDate and/or transactionEndDate	Invalid date format in deferred OCT queries	transactionDetails.serviceProcessingType.deferredDateTime
400	11055	Value provided for one of the fields is invalid.	Validation failed for transactionStartDate and transactionEndDate	Various deferred OCT date validation failures	transactionDetails.serviceProcessingType.deferredDateTime
400	11055	Value provided for one of the fields is invalid.	Recipient Payment Credential Reference value is invalid	Invalid PayName credential reference	recipientDetail.paymentCredentialReference.value
400	11055	Value provided for one of the fields is invalid.	Recipient Payment Credential Reference value not found	PayName not found	recipientDetail.paymentCredentialReference.value
400	11055	Value provided for one of the fields is invalid.	Payment Credential Reference value is invalid	Invalid PCI token credential reference	recipientDetail.paymentCredentialReference.value
400	11055	Value provided for one of the fields is invalid.	Sender Payment Credential Reference value is invalid	Invalid sender PCI token reference	senderDetail.senderAccountNumber
400	11055	Value provided for one of the fields is invalid.	Payment Credential recipientpaymentCredentialReferenceReference.type not supported	Unsupported alias credential reference type	recipientDetail.paymentCredentialReference.type
400	11055	Value provided for one of the fields is invalid.	Payment Credential recipientpaymentCredentialReferenceReference.filters has invalid content	Invalid alias filters	recipientDetail.paymentCredentialReference.filters
400	11055	Value provided for one of the fields is invalid.	Recipient Payment Credential Reference value not found	Alias not found	recipientDetail.paymentCredentialReference.value
400	11055	Value provided for one of the fields is invalid.	Recipient Payment Credential Reference value is invalid	Invalid alias credential reference	recipientDetail.paymentCredentialReferenceReference.value
400	11057	Value is missing or invalid	Mandatory field 'Name' is missing or has invalid content	Missing or invalid card acceptor name	originatorDetail.cardAcceptor.name
400	11057	Value is missing or invalid	Mandatory field 'TerminalId' is missing or has invalid content	Missing or invalid terminal ID	originatorDetail.cardAcceptor.terminalId
400	11057	Value is missing or invalid	Mandatory field 'IdCode' is missing or has invalid content	Missing or invalid card acceptor ID code	originatorDetail.cardAcceptor.id
400	11057	Value is missing or invalid	Mandatory field 'CardAcceptor City' is missing or has invalid content	Missing or invalid card acceptor city	originatorDetail.cardAcceptor.address.city
400	11057	Value is missing or invalid	Mandatory field 'Country' is missing or has invalid content	Missing or invalid card acceptor country	originatorDetail.cardAcceptor.address.country
400	11057	Value is missing or invalid	The MerchantCategoryCode field is missing or has invalid content	Missing merchant category code	originatorDetail.cardAcceptor.merchantCategoryCode
400	11059	One of the objects are required and both objects are mutually exclusive. Ob1 and Ob2 are mutually exclusive. One of the Object shoudl be present with valid value.	One of Payment Credential Reference PAN or Network Token is expected	Both recipient token ID and recipient primary account number provided or neither provided	recipientDetail.paymentCredentialReferenceReference,recipientDetail.card
400	11060	The State field is missing or has invalid content	The State field is missing or has invalid content	Invalid state field for US/Canada addresses	Unknown
400	11061	The PostalCode field is missing or has invalid content	The ZipCode field is missing or has invalid content	Invalid zip code format for US/Canada addresses	Unknown
400	11062	ColombiaNationalServiceData is expected only when country code is Colombia	ColombiaNationalServiceData is expected only when country code is Colombia	Colombia national service data provided for non-Colombia country	transactionDetail.additionalData
400	11064	MexicoNationalServiceData is expected only when AcquirerCountryCode is Mexico	MexicoNationalServiceData is expected only when AcquirerCountryCode is Mexico	Mexico national service data provided for non-Mexico acquirer country	transactionDetail.additionalData
400	11065	Duplicate value not allowed	Duplicate idType value found in 'cardAcceptor.paymentFacilitator.additionalAcceptor.ids'	Duplicate ID type in additional acceptor IDs	originatorDetail.cardAcceptor.paymentFacilitator.additionalAcceptor.ids
400	11066	API transactions are blocked as per your sponsoring bank	API transactions are blocked as per your sponsoring bank	Transaction control block by sponsoring bank	Unknown
400	11071	Not allowed for this transfer	Field 'visaMerchantIdentifier' should not be present in the request	Visa merchant identifier present when not allowed	originatorDetail.cardAcceptor.visaMerchantIdentifier
400	11072	Sensitive Information is not allowed	Field 'integratedCircuitCardData' includes sensitive information	Sensitive ICC tags present in card data	recipientDetail.card.posData.integratedCircuitCardData
400	11073	Transaction to Recipient Card Country is restricted by the Sender Institution	Transaction to Recipient Card Country is restricted by the Sender Institution	Country filter restriction violation	Unknown
400	11074	Transactions to card and platform code are not permitted	Transactions to card and platform code are not permitted	Velocity card type and platform restriction	Unknown
400	11075	Transactions to cards not permitted	Transactions to cards not permitted	Velocity card type restriction	Unknown
400	11076	Limit Exceeded. Please contact your sponsoring bank for more details.	Limit Exceeded	Velocity limit exceeded for transaction	Unknown
400	11077	Unable to retrieve PAN from Token	Unable to retrieve PAN from Token	Token to PAN conversion failed	recipientDetail.card.accountNumber
400	11078	Invalid Token Requester Id	Invalid Token Requester Id	Invalid token requester identifier	Unknown
400	11079	Token expired	Token expired or deactivated	Network token expired or deactivated	recipientDetail.card.accountNumber
400	11080	Transactions to recipients with card billing currency other than those specified by the acquirer sponsor not permitted	Transactions to recipients with card billing currency other than those specified by the acquirer sponsor not permitted	Currency restriction by acquirer sponsor	Unknown
400	11081	Reserved retrieval reference number used	The value sent in retrievalReferenceNumber is reserved for Visa's internal use	Reserved retrieval reference number used	transactionDetails.clientReferenceId
400	11082	One of recipient's Payment Credential Reference PAN or Network Token is allowed	One of recipient's Payment Credential Reference PAN or Network Token is allowed	Multiple payment credentials provided for PayName	recipientDetail.paymentCredentialReference.value
400	11083	Unable to resolve the Payment Credential Reference, please try after sometime.	PayName service unavailable due to circuit breaker	PayName service circuit breaker activated	recipientDetail.paymentCredentialReference.value
400	11084	Unable to resolve the Payment Credential Reference.	PayName request timeout	PayName service timeout	recipientDetail.paymentCredentialReference.value
400	11085	Client does not have permission to use the provided Visa+ payname	Client does not have permission to use the provided Visa+ payname	PayName authorization failure	recipientDetail.paymentCredentialReference.value
400	11086	PCI Token service unavailable	PCI Token service unavailable	PCI tokenization service unavailable	recipientDetail.paymentCredentialReference.value
400	11087	One of recipient's Payment Credential Reference PAN or Network Token is allowed	One of recipient's Payment Credential Reference PAN or Network Token is allowed	Multiple payment credentials for PCI token recipient	recipientDetail.paymentCredentialReference.value
400	11088	Unable to resolve the Payment Credential Reference. Please try after some time.	PCI Token service unavailable due to circuit breaker	PCI token service circuit breaker	recipientDetail.paymentCredentialReference.value
400	11089	Multiple payment credentials for PCI token sender	One of sender's Payment Credential Reference PAN or Network Token is allowed	Multiple payment credentials for PCI token sender	recipientDetail.paymentCredentialReference.value
400	11090	Unable to resolve the Payment Credential Reference.	PCI Token request timeout	PCI tokenization service timeout	recipientDetail.paymentCredentialReference.value
400	11091	PCI token forbidden - insufficient permissions	Client profile does not have permission to perform detokenization	PCI token forbidden - insufficient permissions	recipientDetail.paymentCredentialReference.value
400	11092	PCI token failed dependency - merchant profile unavailable	Client profile for provided Merchant ID is unavailable	PCI token failed dependency - merchant profile unavailable	recipientDetail.paymentCredentialReference.merchantId
400	11093	Multiple values for CURRENCY_CODE not supported	Multiple values for CURRENCY_CODE not supported	Multiple currency codes in alias filters	recipientDetail.paymentCredentialReference.filters
400	11094	One of recipient's Payment Credential Reference PAN or Alias is allowed	One of recipient's Payment Credential Reference PAN or Alias is allowed	Multiple payment credentials for alias recipient	recipientDetail.paymentCredentialReference.filters
400	11095	Unable to resolve the Payment Credential Reference, please try after sometime.	Unable to resolve the Payment Credential Reference, please try after sometime.	Unable to resolve the Payment Credential Reference, please try after sometime.	recipientDetail.paymentCredentialReference.value
400	11096	Alias can not be resolved for the given search criterion.	Alias can not be resolved for the given search criterion.	Alias can not be resolved for the given search criterion.	recipientDetail.paymentCredentialReference.value
400	99999	Please contact your Visa Representative	Please contact your Visa Representative	Internal system error or unexpected VIP response	Unknown
400	99999	Please contact your Visa Representative	Please contact your Visa Representative	Internal server error or system unavailable	Unknown
400	11058	Time is outside 3 days past or future window.	Mandatory field 'localTransactionDateTime' is missing or has invalid content.	Time is outside 3 days past or future window.	transactionDetail.localTransactionDateTime

Http Code	Thin Layer Error Code	Thin Layer Message	Cause	Description	Location
400	11000	Not allowed for Card Present transaction	PinData is expected only in a Card present card read AFT transaction.	PinData is expected only in a Card present card read AFT transaction.	'transactionDetail.posData.pinData
400	11057	Value is missing or invalid	Mandatory field 'SenderCurrencyCode' is missing or has invalid content.	Mandatory field 'SenderCurrencyCode' is missing or has invalid content.	transactionDetail.transactionCurrencyCode
400	11054	Value provided for one of the fields has incorrect format	Mandatory field 'Surcharge' is missing or has invalid content.	Mandatory field 'Surcharge' is missing or has invalid content.	transactionDetail.fees.surcharge
400	11054	Value provided for one of the fields has incorrect format	Mandatory field 'ForeignExchangeFeeTransaction' is missing or has invalid content.	Mandatory field 'ForeignExchangeFeeTransaction' is missing or has invalid content.	transactionDetail.fees.foreignExchangeFee
400	11054	Value provided for one of the fields has incorrect format	ReimbursementFee is not in the correct format to be transformed.	ReimbursementFee is not in the correct format to be transformed.	transactionDetail.additionalData.value[n].mexicoNationalServiceData.reimbursementFee
400	11055	Value provided for one of the fields is invalid.	Field 'track1Data/track2Data' is missing.	Field 'track1Data/track2Data' is missing.	transactionDetail.posData.magneticStripeData
400	11055	Value provided for one of the fields is invalid.	Field 'track1Data/track2Data' is missing or has invalid content.	Field 'track1Data/track2Data' is missing or has invalid content.	transactionDetail.posData.magneticStripeData
400	11055	Value provided for one of the fields is invalid.	Field 'track1Data' has invalid content.	Field 'track1Data' has invalid content.	transactionDetail.posData.magneticStripeData.track1Data
400	11055	Value provided for one of the fields is invalid.	Field 'track2Data' has invalid content.	Field 'track2Data' has invalid content.	transactionDetail.posData.magneticStripeData.track2Data
400	11055	Value provided for one of the fields is invalid.	Field 'PinBlockFormatCode' has invalid content.	Field 'PinBlockFormatCode' has invalid content.	transactionDetail.posData.pinData.pinBlockFormatCode
400	11055	Value provided for one of the fields is invalid.	Field 'ZoneKeyIndex' has invalid content.	Field 'ZoneKeyIndex' has invalid content.	transactionDetail.posData.pinData.zoneKeyIndex
400	11055	Value provided for one of the fields is invalid.	Field 'MotoECIIndicator' has invalid content.	Field 'MotoECIIndicator' has invalid content.	transactionDetail.posData.motoECIIndicator
400	11055	Value provided for one of the fields is invalid.	Field 'PosTerminalType' has invalid content.	Field 'PosTerminalType' has invalid content.	transactionDetail.posData.pointOfServiceCapability.terminalType
400	11055	Value provided for one of the fields is invalid.	Field 'PosTerminalEntryCapability' has invalid content.	Field 'PosTerminalEntryCapability' has invalid content.	transactionDetail.posData.pointOfServiceCapability.terminalEntryCapability
400	11055	Value provided for one of the fields is invalid.	Field 'PosTerminalType/PosTerminalEntryCapability' has invalid content.	Field 'PosTerminalType/PosTerminalEntryCapability' has invalid content.	transactionDetail.posData.pointOfServiceCapability.terminalType or transactionDetail.posData.pointOfServiceCapability.terminalEntryCapability
400	11055	Value provided for one of the fields is invalid.	Field 'PanEntryMode/PosConditionCode/MotoECIIndicator' has invalid content.	Field 'PanEntryMode/PosConditionCode/MotoECIIndicator' has invalid content.	transactionDetail.posData.panEntryMode
400	11057	Value is missing or has invalid content	Mandatory field 'posTerminalType,posTerminalEntryCapability' is missing or has invalid content.	Mandatory field 'posTerminalType,posTerminalEntryCapability' is missing or has invalid content.	transactionDetail.posData.pointOfServiceCapability.terminalType and transactionDetail.posData.pointOfServiceCapability.terminalEntryCapability
400	11057	Value is missing or has invalid content	Field 'recipientDateOfBirth' is missing or has invalid content.	Field 'recipientDateOfBirth' is missing or has invalid content.	recipientDetail.dateOfBirth
400	11057	Value is missing or has invalid content	Field 'senderDateOfBirth' is missing or has invalid content.	Field 'senderDateOfBirth' is missing or has invalid content.	senderDetail.dateOfBirth
400	11057	Value is missing or has invalid content	Mandatory field 'posTerminalType' is missing or has invalid content.	Mandatory field 'posTerminalType' is missing or has invalid content.	transactionDetail.posData.pointOfServiceCapability.terminalType
400	11057	Value is missing or has invalid content	Mandatory field 'posTerminalEntryCapability' is missing or has invalid content.	Mandatory field 'posTerminalEntryCapability' is missing or has invalid content.	transactionDetail.posData.pointOfServiceCapability.terminalEntryCapability
400	11058	Time is outside 3 days past or future window.	Mandatory field 'localTransactionDateTime' is missing or has invalid content.	Mandatory field 'localTransactionDateTime' is missing or has invalid content.	transactionDetail.localTransactionDateTime
400	11062	ColombiaNationalServiceData is expected only when country code is Colombia	ColombiaNationalServiceData is expected only when country code is Colombia.	ColombiaNationalServiceData is expected only when country code is Colombia.	transactionDetail.additionalData
400	11063	ArgentinaNationalServiceData is expected only when AcquirerCountryCode is Argentina	ArgentinaNationalServiceData is expected only when AcquirerCountryCode is Argentina.	ArgentinaNationalServiceData is expected only when AcquirerCountryCode is Argentina.	transactionDetail.additionalData
400	11065	Duplicate value not allowed	Duplicate idType value found in 'cardAcceptor.paymentFacilitator.additionalAcceptor.ids'.	Duplicate idType value found in 'cardAcceptor.paymentFacilitator.additionalAcceptor.ids'.	originatorDetail.cardAcceptor.paymentFacilitator.additionalAcceptor.ids

HTTP Code	Thin Layer Error Code	Thin Layer Message	Description	Cause	Location
400	45004	Original transaction is not found.	Original transaction is not found.	Original transaction is not found.	Undefined
400	45005	adjustmentType is not allowed.	adjustmentType is not allowed.	adjustmentType is not allowed.	transactionDetail.adjustmentType

HTTP Code	Thin Layer Error Code	Thin Layer Message	Description	Cause	Location
400	11055	Value is missing or has invalid content	Mandatory field 'TransactionCurrencyCode' is missing or has invalid content	Invalid or non-existent transaction currency code when corrections enabled	transactionDetail.transactionCurrencyCode
400	11057	Value is missing or has invalid content	Mandatory field 'messageReasonCode and transactionTypeCode' is missing or has invalid content	Both message reason code and transaction type code missing for non-whitelisted clients	transactionDetail.adjustmentType
400	11055	Value provided for one of the fields is invalid	Mandatory field 'messageReasonCode' is missing or has invalid content	Missing message reason code for non-whitelisted clients	transactionDetail.adjustmentType
400	11055	Value is missing or has invalid content	Mandatory field 'transactionTypeCode' is missing or has invalid content	Missing transaction type code for non-whitelisted clients	transactionDetail.adjustmentType
400	11097	Not allowed for the client.	Field 'messageReasonCode and transactionTypeCode' should not present in the request	Message reason code and transaction type code present for whitelisted clients	transactionDetail.adjustmentType
400	11097	Not allowed for the client.	Field 'messageReasonCode' should not present in the request	Message reason code present for whitelisted clients	transactionDetail.adjustmentType
400	11055	Value provided for one of the fields is invalid	Field 'transactionTypeCode' should not present in the request	Transaction type code present for whitelisted clients	transactionDetail.adjustmentType
400	11057	Value is missing or has invalid content	Mandatory field 'PointOfServiceData' is missing or has invalid content	Missing point of service data when required for non-whitelisted clients	transactionDetail.posData

HTTP Code	Thin Layer Error Code	This Layer Error Message	Description	Cause
400	11055	Value provided for one of the fields is invalid.	Enrich Core API Query Params , if initial Params are empty	Query parameters are empty
400	11055	Value provided for one of the fields is invalid.	Before making DB call the request params are validated	Query parameters value is invalid