Below is a list of possible error codes, along with additional information about how to resolve them. The error codes are HTTP response status codes that indicate an error because of the information provided (for example, a parameter was omitted).
The account activation call failed because a deactivated address of category=user_payout is not available.
For account.business_details.type $business_type, person with following relationship(s) $person_relationship must be present before the account can be activated.
The account activation call failed because more than 1 person was passed for entity of type individual or sole_proprietor.
The account activation call failed because an incorrect relationship was assigned to the person. For entity of type individual or sole_proprietor, only relationship.owner can be set to true.
The email address is invalid (e.g. not properly formatted). Check that the email address is properly formatted and only includes allowed characters: https://en.wikipedia.org/wiki/Email_address#Local-part
You have provided an invalid account identifier for @parameter_name. Please provide a valid account identifier to proceed with the request.
You have already used this nickname for a different user/partner. Please retry the request with a unique nickname.
You are trying to update a parameter that is not allowed to be edited. Please refer our API documentation page and retry the request with only the allowed updatable parameters.
You are trying to activate an account of type=partner that is in verifying status. You can perform this action only on accounts in deactivated status.
You are trying to deactivate an account of type=partner that is in verifying status. You can perform this action only on accounts in activated status.
You are trying to activate an account of type=platform. This is not allowed on the API. This type of account must be activated through the Xflow Dashboard.
You are trying to create an account of type=platform. You can only create accounts of type=user and type=partner.
You are trying to update a parameter that is not allowed to be edited. Please refer our API documentation page and retry the request with only the allowed updatable parameters.
You have provided an account with $status status. Please retry the request with an account in one of these statuses: $allowed_statuses. If your account is in hold status, you can perform only read actions. Other API calls are not possible. If your partner's account is in hold status, you can perform only read actions on objects associated with the partner. Write actions are not possible. Please reach out to support@xflowpay.com for help.
You have provided an invalid account type for @parameter_name. Please retry the request with a valid account of type $type1, $type2.
You do not have access to update this account. This account was created and is managed by Xflow for specific purposes (e.g. representing a partner for paying out platform fees).
You are trying to activate an account of type=user. This is not allowed. You can activate only account of type=partner.
You are trying to create an account of type=user. You can only create account of type=partner.
The action you are trying to perform is invalid.
The action you are trying to perform is currently not enabled. We will enable it in the future.
The action you are trying to perform is not authorized.
You cannot deactivate addresses associated with an account if account.address is in processing or activated state.
You have provided an address with category $category1 whereas the expected category was $category2. Please provide an address with the expected category.
You are trying to create an address of category user_payout with an unsupported country. Re-try the request by using the appropriate address.category or use one of the supported countries ($supported_countries).
You are trying to create an address with $domestic_credit, which is an invalid routing code (routing codes vary by country. In India, a routing code is also known as IFSC or Indian Financial System Code). Please enter a valid routing code to create the address.
You are trying to create or update an address with an invalid BIC or Business Identifier Code. Please enter a valid BIC to proceed.
You are trying to create or update an address with a BIC or Business Identifier Code that is not currently supported by Xflow. Please retry the request with a supported BIC.
You are trying to create or update an address with an invalid International Bank Account Number (IBAN). Please enter a valid IBAN to proceed.
You are trying to update an address of type $type. You can only update the parameter metadata on an address.
You can only create and update an address of type bank_account.
Either vpa.upi.one_time or vpa.upi.recurring should be set to enabled.
You cannot transfer an amount greater than what is present in the from account identifier balance. Please retry the request with a smaller @parameter_name.
You have already cancelled this $object_name. You cannot cancel this again.
You are trying to create or update an $object_name with $country which is not a valid country code. Please retry the request with a valid country code. You can find the country codes here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
You are trying to create or update an $object_name with $country which is not supported. Please retry the request with a supported country code.
You are trying to create a transactionIntent but your account is missing an activated address of type=vpa and category=user_payout. Please reach out to support@xflowpay.com and we will help you out.
You are making a request with amount=$amount. However, the currency you are using is a $number_of_decimal_places_supported-decimal currency. Please retry your request with the correct number of decimals.
You are trying to use a currency that is not supported by Xflow at the moment or provided an incorrect currency code. Xflow currently supports the following currencies: $supported_currencies.
You have provided a date in an invalid format. The expected date format is YYYY-MM-DD. Please provide the date in the correct format and retry the request.
You cannot provide a future date for the date_of_incorporation. Please provide a valid date and retry your request.
The deposit.from.account_id or deposit.to.account_id does not match the account to which the deposit.to.address_id belongs.
You are trying to create a deposit with different deposit.from.account_id and deposit.to.account_id. Please retry the request with the same deposit.from.account_id and deposit.to.account_id.
You are trying to update a parameter that is not allowed to be updated. You can update only metadata for a deposit object.
Xflow does not support duplicate currencies when actioning on an object.
You have provided duplicate values for $parameter_name. Please retry with unique values.
You are using an invalid event. Please choose from a list of valid event types and retry this request. A full list of the latest event types is available here: https://docs.xflowpay.com/latest/api#types-of-events
You are trying to update a parameter that is not allowed to be edited. Please refer our API documentation page and retry the request with only the allowed updatable parameters.
You are using invalid characters for your file name. The allowed characters are [A-Z, a-z, 0-9, "/", "", "-", ":", "?", "(", ")", ".", ",", "_", "'", "+", " "]. Please retry the request with appropriate characters for file name.
The allowed length for file name is $x characters. Please retry the request with an appropriate length.
You are trying to update a parameter that is not allowed to be updated. You can only update metadata and purpose for a file object.
You have provided a file with $purpose1 whereas the expected purpose was $purpose2. Please provide a file with the expected purpose.
You are trying to upload a file with an invalid multipart request body. For example, file has no content, file name is not set or empty, payload is empty, or the closing boundary for the multipart request is missing. Please check your request and retry.
The file you are trying to upload is larger than $max_file_size. Please retry the request with a file smaller than $max_file_size.
You are trying to create a file which has an unsupported format. You can create files with the following formats - jpeg, pdf and png. Please retry with a valid file format.
You are trying to create a request but the $header header value is set incorrectly. Please retry the request with the correct header value.
You are trying to create a request but the $header header is missing. Please retry the request with the correct header value.
The hsn code you have provided is incorrect or is not supported by Xflow. Please check the list of supported hsn codes here: https://docs.xflowpay.com/hsn-codes
The HTTP URL provided or the HTTP method used is invalid.
You are trying to create a $object_name with an invalid amount. Please use an amount > 0 and retry.
You are trying to create a subscription with an invalid value for execution_anchor. For interval = daily, no anchor can be set, for interval = weekly anchor has to be between 1 to 7 (1 for Sunday, 2 for Monday and so on..), for interval = monthly anchor can be between 1 to 31, for interval=yearly, the value can be between 1 and 12. 1 being January, 2 being February and so on. Please try again with a different value.
You are trying to create a subscription with an invalid validity_end_date. Please try again with a date that is today or later. The difference between validity_start_date and validity_end_date should be at least one interval long.
You are trying to create a subscription with an invalid validity_start_date. Please try again with a date that is today or later
You cannot provide a due date which is older than the invoice creation date. Please provide a valid date and retry your request.
You cannot provide a due date which is older than the invoice creation date. Please provide a valid date and retry your request.
The merchant category code is not supported. Please check the list of supported merchant category codes here: https://docs.xflowpay.com/mcc
You can add only 10 key-value pairs as metadata.
The maximum length for metadata key is 40 characters. Please retry the request with an appropriate length.
The minimum length for metadata key is 1 character(s). Please retry the request with an appropriate length.
The maximum length for metadata value is 500 characters. Please retry the request with an appropriate length.
The minimum length for metadata value is 1 character(s). Please retry the request with an appropriate length.
Xflow supports a single address of category=xflow_receive per currency per account. Please check to see if there already exists an address with this constraint or retry the request keeping this by changing the currency or account identifier.
You have not provided the minimum required value(s) for @parameter_name. Please refer to $documentation_link for more details.
You are trying to access an object that does not exist. Please try again with the correct object identifier.
You have provided an invalid address id for @parameter_name. Please provide valid ids to proceed with the request.
You are passing a value that is not as per the expected format of @parameter_name. The value is expected in the following regular expression format: $format. Please retry the request with correct value for @parameter_name.
You did not provide a value for @parameter_name. Please try again with an appropriate value.
You have provided an invalid file id for @parameter_name. Please provide valid ids to proceed with the request.
The maximum allowed length for @parameter_name is $x. Please retry the request with an appropriate length.
The minimum length for @parameter_name is $x. Please retry the request with an appropriate length.
You have provided an invalid value for @parameter_name. Please provide a valid value to proceed with the request.
You have provided an invalid receivable_id for @parameter_name. Please provide a valid id to proceed with the request.
You have provided a parameter which is not expected. Please refer our API documentation page and retry the request with only the required parameters.
We got an invalid value for @parameter_name. Please retry the request with one of the following values: $valid_values.
You are trying to create a PaymentLink using an account_id which does not match with the account_id of the receivable_id provided. Please retry the action using a receivable_id created against the account for which you are creating the PaymentLink.
You are trying to activate a PaymentLink in expired status. Please create a new PaymentLink.
You are trying to deactivate a PaymentLink that has expired. This is not a valid action.
You are trying to expire a PaymentLink that is not linked to a receivable. You can only expire a PaymentLink that is linked to a receivable.
You are trying to extend a PaymentLink that is not in activated status. Please retry extend action on a PaymentLink in activated status or create a new PaymentLink.
You are trying to extend a PaymentLink that is not linked to a receivable. You can only extend a PaymentLink that is linked to a receivable.
You are trying to create a PaymentLink for a partner who is not based in US or for a non USD receivable. PaymentLink is currently available only for account of type=partner with country=US and for a receivable with currency=USD.
You are trying to update a parameter that is not allowed to be updated. You can update only metadata for a PaymentLink object.
The maximum number of receivables you can set against a PaymentLink is 1. Please retry creating the PaymentLink with 1 receivable.
You are trying to create a PaymentLink using a receivable that is in $status status. Please retry the request using a receivable that is in one of these statuses: $allowed_statuses.
You are trying to update a parameter that is not allowed to be updated. You can update only metadata for a payout object.
You can only delete a person if its status is unverified.
You are trying to update a parameter that is not allowed to be edited. Please refer our API documentation page and retry the request with only the allowed updatable parameters.
You must set at least one of the relationship parameters as true.
You can only update a person if its status is unverified.
The purpose code you have provided is not supported by Xflow or an incorrect purpose code. Please check the list of supported purpose codes: https://docs.xflowpay.com/purpose-codes
We need some more information to process this receivable. Please reach out to support@xflowpay.com or check your mail for more details.
The amount on the invoice does not match with amount you have provided. Please retry the request with the correct amount.
The amount_maximum_reconcilable should be less than invoice.amount and greater than amount_settled_payouts + amount_locked. You also cannot change the amount_maximum_reconcilable to an amount less than reconciled amount. Please provide an appropriate amount and retry updating the receivable.
You cannot cancel a receivable if it has funding associated or has been paid out to your bank account or if there is amount_locked associated.
You can confirm a receivable that is in draft or input_required status only. Please retry the request on a receivable in one of the statuses mentioned.
The invoice date on the invoice does not match with invoice date you have provided. Please retry the request with the correct invoice date.
The receivable.currency does not match with receivable.invoice.currency. Please retry the request with same receivable.currency and receivable.invoice.currency.
The due date on the invoice does not match with due date you have provided. Please retry the request with the correct due date.
The receivable you are trying to action on is in hold status. Read actions are allowed and other API calls are not possible on this receivable. Please reach out to support@xflowpay.com to change status of the receivable from hold to activated.
We currently do not support receivables with invoice.amount > INR 25,00,000.
The document you have uploaded is not a valid invoice. Please retry the request with the correct document.
You are trying to create a receivable with an invoice reference number that already exists. Please update the existing receivable or try creating a receivable with a different invoice reference number.
The type of transaction on the invoice does not match with the transaction type you have selected. Please retry the request with the correct document.
You are trying to update a parameter that is not allowed to be edited. Please refer our API documentation page and retry the request with only the allowed updatable parameters.
We need additional information about the partner account associated with the receivable. Please provide a valid value for account.business_details.ids.tax.
The country of the partner on the invoice does not match with the country of the partner you have provided. Please retry the request after updating the country of the partner.
The partner information on the invoice does not match with partner information you have provided. Please retry the request with the correct partner information.
You cannot reconcile a receivable unless it is in activated status. Please retry once the receivable is in activated status.
You cannot reconcile a receivable for an amount less than $payout_fee while account_settings.live_fx is enabled. Please either increase the reconcile amount above $payout_fee or disable account_settings.live_fx and try again.
You cannot reconcile a receivable for an amount greater than receivable.amount_reconcilable or an amount greater than what the partner has deposited or what is present in the source account identifier balance. Please retry the request with a smaller amount or update the receivable.amount_maximum_reconcilable.
You are trying to reconcile a receivable but the associated address ${address_id} of category=user_payout is not activated. Please reach out to support@xflowpay.com and we will help you out.
You are trying to reconcile a receivable but the amount is below the minimum threshold of ${currency} ${minimum_amount}. Please try to reconcile the receivable with an amount above the minimum threshold.
You are trying to reconcile a receivable with an amount that will leave the receivable with a reconcilable amount lower than the minimum threshold of ${currency} ${minimum_amount}. This will prevent further reconciliations. Please try to reconcile the receivable with the remaining reconcilable amount in full.
The invoice id on the invoice does not match with invoice_id you have provided. Please retry the request with the correct invoice id.
The transaction_type on this receivable is not supported for this account. Please retry the request with transaction_type = ${user_product_category}
We are unable to process this receivable currently.
You do not have access to update this receivable. This receivable was created and is managed by Xflow for specific purposes (e.g. receiving funds for platform fees).
You have provided an invalid reconcile_id. Please try again with a valid reconcile_id or reach out to support@xflowpay.com
You have provided an invalid request body (e.g. - json syntax). Please check your request and retry.
You have provided an invalid request query parameter (e.g. - unexpected parameters or incorrect data type). Please check your request and retry.
This object cannot be accessed right now because another API request or Xflow process is currently accessing it. If you see this error intermittently, retry the request. If you see this error frequently and are making multiple concurrent requests to a single object, make your requests serially or at a lower rate.
The API key you've used in your request is invalid. Obtain your current secret API key from the Dashboard and update your integration to use them.
You have not provided an API key. Obtain your current secret API key from the Dashboard and update your integration.
We currently do not support creating Subscriptions with subscription.payment_method=${payment_method} with subscription.amount > ${currency} ${maximum_amount}.
We currently do not support creating subscriptions where the difference between validity_start_date and validity_end_date is > 30 years
You are trying to update a parameter that is not allowed to be edited. Please refer our API documentation page and retry the request with only the allowed updatable parameters.
The action you are trying to perform is valid only in testmode. Please retry the action using your test key and inputs.
You have provided an invalid input for timestamp. The timestamp needs to be an integer between -30610224000 and 253402300799. Please retry your request with an appropriate input.
We currently do not support creating TransactionIntents with transaction_intent.payment_method=${payment_method} with transaction_intent.amount > ${currency} ${maximum_amount}.
You are trying to update a parameter that is not allowed to be edited. Please refer our API documentation page and retry the request with only the allowed updatable parameters.
The requested transfer has failed. Please try again after some time.
The deposit_id is either incorrect or was used in a prior transfer. Please reach out to support@xflowpay.com if you want to reverse a prior transfer made with this deposit_id.
You have provided an invalid type for ${field_name}. Please retry the request with a valid linked_object of type ${valid_types}.
You are trying to update a parameter that is not allowed to be updated. You can update only description and metadata for a transfer object.
You have provided an invalid transfer type for @parameter_name. Please retry the request with a valid transfer of type $type1, $type2.
The URL provided is invalid.
You have reached the maximum allowed limit of 16 webhook endpoints. Please reuse existing endpoints by using the update API.
You are trying to update a parameter that is not allowed to be edited. Please refer our API documentation page and retry the request with only the allowed updatable parameters.
You have provided an invalid website value. Please provide a valid url or pass website_not_available.