Error handling
Effectively handle declines, validation issues, and other challenges
Veem offers a variety of errors. These can result from external events, such as declined payments or invalid API requests.
Account
Here you can find the errors related to the account endpoints, such as POST /veem/v1.2/account. These errors provide comprehensive details to assist in identifying and resolving issues that may occur when interacting with Veem API.
| Code | Numeric Code | Description |
|---|---|---|
| INVALID_COUNTRY_CODE | 50001201 | The specified ISO country code is invalid: X |
| INVALID_EMAIL_ADDRESS | 50001202 | The email address X is invalid |
| PARTIAL_EMAIL_TOO_SHORT | 50001203 | Email search requires at least X characters. X is too short |
| MISSING_BANK_ACCOUNT | 50001204 | No bank account set up for account X |
| EMPTY_ACCOUNT_REQUEST | 50001205 | Account request is empty |
| MISSING_COUNTRY_CODE | 50001206 | ISO country code is missing |
| MISSING_ACCOUNT_TYPE | 50001207 | Account type is missing |
| FIRST_NAME_IS_BLANK | 50001208 | First name is empty |
| LAST_NAME_IS_BLANK | 50001209 | Last name is empty |
| BUSINESS_NAME_IS_BLANK | 50001210 | Business name is empty |
| PHONE_NUMBER_IS_BLANK | 50001211 | Phone number is empty |
| INVALID_NUMBER_FOR_REGION | 50001212 | Invalid number for region: X |
| INVALID_CURRENCY_CODE | 50001213 | The currency is not acceptable: X |
| PAYER_CANNOT_SEND_PAYMENT | 50001214 | The payer country X cannot send any payment |
| PAYEE_CANNOT_RECEIVE_PAYMENT | 50001215 | The payee country X cannot receive any payment |
| MISSING_CURRENCY_CODE | 50001216 | Currency code is missing |
| CONTRACTOR_CANNOT_SEND_PAYMENT | 50001217 | Payer cannot be a contractor |
| FUNDING_METHOD_NOT_FOUND | 50001218 | Funding method of type X not found |
| BANK_ACCOUNT_NOT_UPDATABLE | 50001219 | Bank account cannot be updated, reason: X |
Error related to bank account information:
| Code | Description |
|---|---|
| VERIFICATION_BANK_PROVIDE_RETURNED_INVALID_INFO | Bank Data Provider returned invalid owner information error. This can be due to incorrect First Name or Last Name for personal bank accounts or incorrect Business Name for business bank accounts |
| VERIFICATION_BANK_ACCOUNT_NO_INFO_WAS_FOUND | No information was found for the given bank account. |
| VERIFICATION_BANK_ACCOUNT_DOB_DOES_NOT_MATCH | The bank account owner’s DOB doesn’t match with the bank data provider |
| VERIFICATION_BANK_ACCOUNT_HIGH_RETURN_PROBABILITY | The bank account is either ineligible for a debit activity or deemed to have a high probability of return. |
| VERIFICATION_BANK_ACCOUNT_HISTORY_BALANCE_LESS_ZERO | The bank account has a history of available balance being less than zero. |
| VERIFICATION_BANK_ACCOUNT_NOT_ACCEPT_DEBIT_ACTIVITY | The bank account will not accept any debit activity. |
| VERIFICATION_BANK_ACCOUNT_OWNER_INFO_DOES_NOT_MATCH_PROVIDER | Bank account owner information does not match with the information provided. |
| VERIFICATION_BANK_ACCOUNT_OWNER_INFO_DOES_NOT_MATCH | Bank account owner information does not with the information provided. |
| VERIFICATION_BANK_ACCOUNT_SSN_TAX_DOES_NOT_MATCH | The bank account owner’s SSN or tax ID doesn’t match with the bank data provider |
| VERIFICATION_BANK_CLOSED | The bank account is closed |
| ACCOUNT_UNDER_REVIEW | Payments may be submitted but Veem will not process the payment, until risk reviews are completed |
| VERIFICATION_SANCTION_MATCH_BLOCK | The individual’s identity does not match any entries in the sanctions database |
Recommended actions for resolving errors related to bank account information:
| Code | Recommended Action |
|---|---|
| VERIFICATION_BANK_PROVIDE_RETURNED_INVALID_INFO | The bank information provided is incorrect. Use the update-bank-info endpoint to update bank details |
| VERIFICATION_BANK_ACCOUNT_NO_INFO_WAS_FOUND | The bank information provided is incorrect. Use the update-bank-info endpoint to update bank details |
| VERIFICATION_BANK_ACCOUNT_DOB_DOES_NOT_MATCH | Few documents need to be provided. You can do it by calling account-document endpoint or contacting Veem: 1. Provide for last 90 days bank statement reflecting full bank account number, routing number, name & address of the customer 2. Provide copy of ID prood showing full name, address, DOB 3. Hold funds for 3-4 business days before releasing |
| VERIFICATION_BANK_ACCOUNT_HIGH_RETURN_PROBABILITY | |
| VERIFICATION_BANK_ACCOUNT_HISTORY_BALANCE_LESS_ZERO | |
| VERIFICATION_BANK_ACCOUNT_NOT_ACCEPT_DEBIT_ACTIVITY | The bank information provided is incorrect. Use the update-bank-info endpoint to update bank details |
| VERIFICATION_BANK_ACCOUNT_OWNER_INFO_DOES_NOT_MATCH_PROVIDER | Additional documents are required. You can submit them using the account-document endpoint or by contacting Veem. The required documents include: 1. Provide for last 90 days bank statement reflecting full bank account number, routing number, name & address of the customer 2. Provide copy of ID prood showing full name, address, DOB Funds will be held for 3–4 business days before being released. |
| VERIFICATION_BANK_ACCOUNT_OWNER_INFO_DOES_NOT_MATCH | Additional documents are required. You can submit them using the account-document endpoint or by contacting Veem. The required documents include: 1. Provide for last 90 days bank statement reflecting full bank account number, routing number, name & address of the customer 2. Provide copy of ID proof showing full name, address, DOB Funds will be held for 3–4 business days before being released. |
| VERIFICATION_BANK_ACCOUNT_SSN_TAX_DOES_NOT_MATCH | Additional documents are required. You can submit them using the account-document endpoint or by contacting Veem. The required documents include: 1. A bank statement from the last 90 days showing the full bank account number, routing number, and the customer's name and address. 2. A copy of an ID proof displaying the full name, address, and date of birth (DOB). 3. The most recent tax return document. Funds will be held for 3–4 business days before being released. |
| VERIFICATION_BANK_CLOSED | The bank information provided is incorrect. Use the update-bank-info endpoint to update bank details |
| ACCOUNT_UNDER_REVIEW | Wait for Veem's response. You can check the account status calling account-status endpoint |
| VERIFICATION_SANCTION_MATCH_BLOCK | Provide a copy of an ID proof that includes your full name, address, and date of birth (DOB). You can upload these documents using the account-document endpoint or contact Veem for assistance. |
Payment
Here you can find the errors related to the payment endpoints, such as POST /veem/v1.2/claimless-payments
and POST /veem/v1.1/payments. These errors provide detailed information to help identify and resolve issues encountered when interacting with Veem APIs.
| Code | Numeric Code | Description |
|---|---|---|
| INVALID_AMOUNT | 50001401 | Amount X cannot be 0.0 or negative |
| NO_DRAFT_ACCESS | 50008002 | User doesn't have access to draft payment |
| SPECIFIED_BOTH_FROM_AND_TO_AMOUNT | 50001402 | Only one of fromAmount and toAmount should be specified |
| FROM_OR_TO_AMOUNT_REQUIRED | 50001403 | One of fromAmount or toAmount must be specified |
| MISSING_PURPOSE_OF_PAYMENT | 50001404 | Purpose of payment is missing |
| MISSING_AMOUNT | 50001405 | Amount must be set |
| INVALID_PURPOSE_OF_PAYMENT | 50001406 | Purpose of payment X is invalid for payee country X |
| INVALID_AMOUNT_NUMBER | 50001407 | Amount number X is not acceptable |
| ACCOUNT_NOT_FOUND | 50000004 | No account found with account id X |
| CONTRACTOR_CANNOT_SEND_PAYMENT | 50001217 | Payer cannot be a contractor |
| PAYER_CANNOT_SEND_PAYMENT | 50001214 | The payer country X cannot send any payment |
| UNSUPPORTED_CURRENCY_FOR_PAYMENT | 50001011 | Currency code X is not supported for payer's country X or payee's country X |
| ATTACHMENT_IS_EMPTY | 50001902 | Attachment is empty |
| FILE_NAME_IS_EMPTY | 50001903 | Attachment file name is empty |
| REFERENCE_ID_IS_EMPTY | 50001904 | Attachment reference id is empty |
| INVALID_CP_ACCOUNT_STATUS_TO_CREATE_PAYMENT | 10001012 | CP account identifier X status is not valid for create payment *CP means Counterparty, in this case usually receiver |
| INVALID_EMAIL_ADDRESS | 50001202 | The email address X is invalid. |
| UNAUTHORIZED_ACCESS | Not allowed to send payment | |
| INVALID_PARAMETER_UNEXPECTED_VALUE | Payments cannot be sent from X (payer country) Payments cannot be sent from X (payer country) in X (payer currency) Payments cannot be sent from X (payer country) in X (payee currency) Payments cannot be sent from X (payer currency) Payments cannot be sent to X (payee country) Payments cannot be sent to X (payee country) in X (payee currency) Payments cannot be sent to X (payee currency) Payments cannot be sent from X in X using method X Cannot create with same payee and payer account id | |
| PAYEENOT_ALLOW_PAYMENT_FROM FUNDING_METHOD | 10010028 | This initiator or CP does not allow payment by X (funding method) *CP means Counterparty, in this case usually receiver |
| OVER_CNY_PERSONAL_RECEIVING_AMOUNT_LIMIT | 10010001 | Due to payment regulations, you may not send amounts of $X or greater |
| VERPERSONAL_ACCOUNT_PAYMENT MAX_AMOUNT | 10009016 | Due to transaction limits, Veem is unable to process a payment larger than X from X at this time |
| NOT_ALLOWED_SENDING_STATES | 10009020 | Account X cannot send personal payment from X |
| DOUBLE_CONVERSION_NOT_SUPPORTED | 10008899 | Double conversion not supported |
| CARD_PAYMENT_MAX_AMOUNT | 10010003 | Card payments support transactions up to X. Reduce the amount and try again |
| VIRTUAL_CARD_INSUFFICIENT_FUND | 10009050 | Virtual card has insufficient funds for this request |
| INVALID_PURPOSE_OF_PAYMENT | 10002017 | X is not a valid purpose of payment for country X |
| INVALIDACCOUNT_TYPE_FOR_RECEIVING PAYMENT_CN | 10002009 | Account type X is not allowed to receive payment in CN *CN means China |
| CHEQUE_PAYMENTS_SEND_DISABLED | 10002007 | Cheque payments sending is disabled |
| MISSING_PURPOSE_OF_PAYMENT_OR_DESC | 10002006 | Missing purpose of payment or purpose of payment description |
| PAYERFUNDING_METHOD_FOR_CHEQUE IS_NOT_BANK | 10002011 | The payer's funding method for a cheque payment must be a US bank |
| PAYER_LOCATION_NOT_VALID_FOR_CHEQUE | 10002012 | The payer's location is not valid to send cheques |
| NO_BANK_ACCOUNT_FOUND | 10000132 | Bank account is not found for account id X |
| PAYERACCOUNT_BANK_LOCATION_DOES NOT_SUPPORT_CHEQUE | 10002010 | The payer's bank account location does not allow sending cheques |
| PAYERFUNDING_METHOD_FOR CHEQUE_IS_NOT_BANK | 10002011 | The payer's funding method for a cheque payment must be a US bank |
| NO_PAYMENT_APPROVE_TIER_FOUND | 10010040 | No payment approve tier found for payment with amount X |
| MISSING_PAYER_ACCOUNT_ID | 10000128 | Missing payer account id |
| INVALID_PARAMETER_NULL | Payee account id and payee no account info cannot both be null Missing amount Missing Required param=X (payer account id) Missing required param=X (payer country) Missing required param= X (processing method) Bill currency and locked currency must be the same Bill amount must positive amount Bill amount must be greater than or equal to locked amount | |
| PAYMENT_NOT_APPROVED | Not all users approved to send payment | |
| INVALID_CP_ACCOUNT_STATUS_TO_SENT_PAYMENT | 10001013 | CP account identifier X status is not valid for send payment |
| NO_ACCOUNT_FOUND | 10000107 | Could not find account for identifier X |
| NOT_EXTERNAL_PAYMENT | 10001005 | Payment X with payer funding method type X is not external payment |
| MISSING_FUNDING_METHOD_ID | 10001002 | Missing funding method id for payment request |
| NO_FUNDING_METHOD_FOUND | 10001004 | Could not find funding method: X for payer account id: X and funding method id: X |
| FAILED_ON_SENDING_EXTERNAL_PAYMENT | 10009003 | Failed on sending external payment to provider X, paymentId X |
| SOMETHING_WRONG_WITH_APPROVAL | 50009009 | There was something wrong, please check your approvals settings |
| OVER_PERSONAL_ACCOUNT_PAYMENT_MAX_AMOUNT | 10009016 | Due to transaction limits, Veem is unable to process a payment larger than X from X at this time |
| NOT_ALLOWED_COUNTRY_PERSONAL_ACCOUNT_PAYMENT | 10009018 | Cannot send personal account payment from X |
| PERSONAL_ACCOUNT_PAYMENT_INBOUND_IS_NOT_SUPPORTED | 10009014 | Personal account payment inbound is not supported: Payer bank country is X, payer amount currency is X |
| OVER_PERSONAL_ACCOUNT_PAYMENT_MAX_AMOUNT | 10009016 | Due to transaction limits, Veem is unable to process a payment larger than X from X at this time |
| INVALID_PAYMENT_AMOUNT | 10008807 | Invalid X amountX, require at least X |
| PAYEE_LOCATION_NOT_VALID_FOR_CHEQUE | 10002013 | The payee's location is not valid to receive cheques |
| INVALID_USER_ZERO_TIER_PAYMENT_USER_TO_SEND_PAYMENT | 10001316 | User X is not in zero-tier approvers List for payment X |
| BANK_ACCOUNT_NOT_UPDATABLE | 50001219 | Bank account cannot be updated, reason: X |
| PAYER_PAYMENT_PREF_IS_NOT_VALID | 10002014 | The payer's payment preference is empty |
Updated 4 days ago