> ## Documentation Index
> Fetch the complete documentation index at: https://developer.tazapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Payout

> Error codes for POST /v3/payout

### POST v3/payout

| Code  | Message                                                                                                                                                          | HTTP Status |
| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| 20003 | Please provide a valid amount                                                                                                                                    | 400         |
| 20028 | Please provide beneficiary name in Chinese                                                                                                                       | 400         |
| 20029 | Please provide valid beneficiary national identification number                                                                                                  | 400         |
| 20030 | Field is required and must be valid logistic tracking details                                                                                                    | 400         |
| 20035 | Transaction not allowed as the ultimate remitter and beneficiary are in the same region and is restricted.                                                       | 400         |
| 20036 | Account holder name is required and cannot be empty                                                                                                              | 400         |
| 20037 | When the txn source is bfi, funding interval should be configured please configure funding interval and try again later                                          | 400         |
| 20038 | Both holding\_fx\_quote and destination\_fx\_quote cannot be provided                                                                                            | 400         |
| 20039 | The amount locked in fx quote is not the same as the amount in request                                                                                           | 400         |
| 20040 | this purpose code is not supported for the Remitter and Beneficiary type combination                                                                             | 400         |
| 20041 | Invalid source for providing destination\_info                                                                                                                   | 400         |
| 20042 | EURC currency is not supported                                                                                                                                   | 400         |
| 20043 | Mismatch detected: The provided destination currency does not align with our system records                                                                      | 400         |
| 20044 | Non-fiat currency is not supported or invalid                                                                                                                    | 400         |
| 20045 | Business-to-business payouts are not permitted for Pakistan. Please select an eligible remitter or beneficiary type.                                             | 400         |
| 20061 | Field is required and must be valid ISO 4217 alpha-3 currency code                                                                                               | 400         |
| 20067 | Holding currency not found for the specified account.                                                                                                            | 400         |
| 20152 | Please provide a valid type                                                                                                                                      | 400         |
| 20165 | Please provide either the beneficiary details or a beneficiary ID. One of these fields is mandatory for processing.                                              | 400         |
| 20166 | Payout risk is not enabled to initiate payout                                                                                                                    | 400         |
| 20167 | Please provide a valid payout currency                                                                                                                           | 400         |
| 20168 | Please provide a valid holding currency                                                                                                                          | 400         |
| 20170 | Payout creation failed: The bank transfer type is swift, which is incompatible with the local payout type                                                        | 400         |
| 20171 | Please provide a valid purpose code to create payout                                                                                                             | 400         |
| 20172 | The requested payout type does not match the beneficiary destination type                                                                                        | 400         |
| 20173 | The requested beneficiary is not associated with the account                                                                                                     | 400         |
| 20174 | Please provide valid transaction source                                                                                                                          | 400         |
| 20175 | Payout invoice document is not found. Please provide valid invoice document                                                                                      | 400         |
| 20196 | Field on\_behalf\_of is required for creating this payout                                                                                                        | 400         |
| 20197 | Please provide valid on\_behalf\_of, should be valid xid type with prefix ent\_                                                                                  | 400         |
| 20198 | Entity doesn't match with tazapay compliance policy. Please contact us at [ops@tazapay.com](mailto:ops@tazapay.com)                                              | 400         |
| 20199 | There is insufficient balance in your account to make the desired payout. Please ensure you have added sufficient funds to your account before retrying.         | 400         |
| 20201 | Payout failed: No available provider for the data provided. The following fields are required by our network for this destination: %s                            | 400         |
| 20231 | Field is required and must be a valid document type.                                                                                                             | 400         |
| 20283 | Provided document is not sufficient to create payout                                                                                                             | 400         |
| 20296 | Requested payout config is not supported, please check the payout config                                                                                         | 400         |
| 20298 | The specified transaction amount does not meet the required minimum or maximum limits.                                                                           | 400         |
| 20299 | Please provide a valid quote, payout or fx quote is expired or mismatch in from and to currency                                                                  | 400         |
| 20380 | Mismatch detected: The provided beneficiary registration number does not align with our system records                                                           | 400         |
| 20381 | Mismatch detected: The provided beneficiary business name does not align with our system records                                                                 | 400         |
| 20382 | Mismatch detected: The provided beneficiary business address country does not align with our system records                                                      | 400         |
| 20383 | Beneficiary date of birth is required and can't be empty when beneficiary type is individual                                                                     | 400         |
| 20384 | Third Party Wallet payout functionality is currently disabled. Please contact support for assistance.                                                            | 400         |
| 20385 | Beneficiary registration number is required and can't be empty                                                                                                   | 400         |
| 20386 | Beneficiary address details are required and can't be empty                                                                                                      | 400         |
| 20387 | Beneficiary party classification is required, please pass valid party classification                                                                             | 400         |
| 20388 | Mismatch detected: The provided individual name does not align with our system records                                                                           | 400         |
| 20389 | Individual business must be a sole proprietorship                                                                                                                | 400         |
| 20400 | Mismatch detected: The provided date of birth does not align with our system records                                                                             | 400         |
| 20401 | VASP name is required for wallet beneficiary                                                                                                                     | 400         |
| 20403 | This wallet beneficiary is not yet approved, please get your beneficiary approved before creating a payout                                                       | 400         |
| 20426 | Field is required and must be a valid payout\_quote\_id                                                                                                          | 400         |
| 20427 | Payout Quote cannot be validated if either holding\_fx\_quote or destination\_fx\_quote is present                                                               | 400         |
| 20428 | Payout quote mismatch with Create Payout request                                                                                                                 | 400         |
| 20434 | Please provide a valid payout quote, payout quote is expired                                                                                                     | 400         |
| 20437 | Please provide a valid destination\_fx\_quote starting with 'fx\_'                                                                                               | 400         |
| 20438 | Please provide a valid quote starting with 'poq\_'                                                                                                               | 400         |
| 20643 | Please provide a valid holding\_fx\_quote starting with 'fx\_'                                                                                                   | 400         |
| 3895  | Account number is required and cannot be empty                                                                                                                   | 400         |
| 3896  | Account number must be alphanumeric and between 4-34 characters                                                                                                  | 400         |
| 3900  | IBAN is required and cannot be empty                                                                                                                             | 400         |
| 3901  | IBAN must be between 15-34 characters                                                                                                                            | 400         |
| 3902  | IBAN must be between 15-34 characters and start with 2 letters, 2 digits, followed by alphanumeric characters                                                    | 400         |
| 3903  | IBAN country code is not supported                                                                                                                               | 400         |
| 3904  | IBAN country code does not match the destination country code                                                                                                    | 400         |
| 3905  | IBAN length is invalid for the specified country                                                                                                                 | 400         |
| 3906  | IBAN checksum validation failed. Please verify that the IBAN is correct                                                                                          | 400         |
| 3907  | IBAN country code is not supported by Tazapay                                                                                                                    | 400         |
| 3910  | SWIFT code is required and cannot be empty                                                                                                                       | 400         |
| 3911  | SWIFT code must be either 8 or 11 characters with format: 4 letters (bank), 2 letters (country), 2 alphanumeric (location), and optional 3 alphanumeric (branch) | 400         |
| 3912  | SWIFT code has invalid location code. Characters 7 and 8 cannot be '00'                                                                                          | 400         |
| 3913  | SWIFT country code is not supported by Tazapay                                                                                                                   | 400         |
| 3915  | BIC code is required and cannot be empty                                                                                                                         | 400         |
| 3916  | BIC code must be either 8 or 11 characters with format: 4 letters (bank), 2 letters (country), 2 alphanumeric (location), and optional 3 alphanumeric (branch)   | 400         |
| 3917  | BIC code has invalid location code. Characters 7 and 8 cannot be '00'                                                                                            | 400         |
| 3918  | BIC country code is not supported by Tazapay                                                                                                                     | 400         |
| 3920  | Sort code is required and cannot be empty                                                                                                                        | 400         |
| 3921  | Sort code must be exactly 6 numeric digits                                                                                                                       | 400         |
| 3925  | ABA routing number is required and cannot be empty                                                                                                               | 400         |
| 3926  | ABA routing number must be exactly 9 numeric digits                                                                                                              | 400         |
| 3927  | ABA routing number has invalid federal reserve prefix (first 2 digits)                                                                                           | 400         |
| 3928  | ABA routing number checksum validation failed (3-7-1 algorithm)                                                                                                  | 400         |
| 3930  | IFSC code is required and cannot be empty                                                                                                                        | 400         |
| 3931  | IFSC code must be exactly 11 characters (4 letters, '0', 6 alphanumeric)                                                                                         | 400         |
| 3935  | BSB code is required and cannot be empty                                                                                                                         | 400         |
| 3936  | BSB code must be exactly 6 numeric digits                                                                                                                        | 400         |
| 3940  | Bank code (Brazil) is required and cannot be empty                                                                                                               | 400         |
| 3941  | Bank code (Brazil) must be either 3 digits (COMPE) or 8 digits (ISPB)                                                                                            | 400         |

#### Internal Service Errors

| Code  | Message                                     | HTTP Status |
| ----- | ------------------------------------------- | ----------- |
| 2051  | Metadata config not found for the account   | 400         |
| 2052  | Risk config not found for the account       | 400         |
| 2053  | Config not supported for this account type  | 500         |
| 2062  | Account ID is missing or invalid            | 400         |
| 2820  | KYB is in dormant state for this account    | 403         |
| 2821  | KYB is in terminated state for this account | 403         |
| 3533  | Invalid beneficiary type provided           | 400         |
| 4000  | Invalid from currency provided              | 400         |
| 4001  | Invalid to currency provided                | 400         |
| 4004  | Invalid FX config provided                  | 400         |
| 4005  | Invalid FX type provided                    | 400         |
| 4006  | Invalid account\_id provided                | 400         |
| 4007  | Invalid admin\_id provided                  | 400         |
| 4009  | Invalid collection currency provided        | 400         |
| 4010  | Invalid customer country provided           | 400         |
| 4011  | Invalid payment method family provided      | 400         |
| 4012  | Invalid from\_amount provided               | 400         |
| 4027  | Non-fiat currency is not supported          | 400         |
| 4303  | Base rate not found                         | 404         |
| 4308  | Live base rate not found                    | 404         |
| 5090  | Invalid account\_id provided (pricing)      | 400         |
| 5091  | Invalid payout transfer type                | 400         |
| 5092  | Invalid destination currency code           | 400         |
| 5093  | Invalid destination amount                  | 400         |
| 5094  | Invalid payout currency code                | 400         |
| 5095  | Invalid payout amount                       | 400         |
| 5096  | Invalid payout wallet type                  | 400         |
| 5097  | Invalid payout quote\_id                    | 400         |
| 5098  | Invalid charge type                         | 400         |
| 43000 | Invalid country provided                    | 400         |
| 43001 | Invalid currency provided                   | 400         |
| 43014 | Invalid bank transfer type provided         | 400         |
