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.