Error handling

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: Provide for last 90 days bank statement reflecting full bank account number, routing number, name & address of the customer Provide copy of ID prood showing full name, address, DOB 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: Provide for last 90 days bank statement reflecting full bank account number, routing number, name & address of the customer 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: Provide for last 90 days bank statement reflecting full bank account number, routing number, name & address of the customer 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: A bank statement from the last 90 days showing the full bank account number, routing number, and the customer's name and address. A copy of an ID proof displaying the full name, address, and date of birth (DOB). 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