Skip to main content
The Payout object has been enhanced to include a new failure object in the response. This provides more structured and cleaner failure information when a payout has failed, making it easier to programmatically identify and handle failure scenarios. We will be deprecating the old failure codes that were populated in the status_description field soon. It is recommended to consume these failure codes instead.
Error CodeCategoryDescription / Message
PF000000General FailuresGeneric fallback, the reason of failure cannot be specified
PF000100General FailuresPayout cancelled on remitter’s request
PF000200General FailuresThe fund transfer network is facing a temporary downtime
PF010000Funding / ExpiryGeneric payout funding or approval failure
PF010100Funding / ExpiryThe payout was not funded within the required time limit.
PF010200Funding / ExpiryThe payout was not approved within the required time limit.
PF010300Funding / ExpiryThe approver rejected the revised exchange rate; the exchange rate for the payout was updated after creation
PF020000Beneficiary / Bank Details Invalid or IncompleteA generic error occurred during beneficiary details validation.
PF020100Beneficiary / Bank Details Invalid or IncompleteThe destination details (bank account details/wallet address/proxy id) are invalid, malformed, or not recognized by the bank/network.
PF020101Beneficiary / Bank Details Invalid or IncompleteBank identification code is missing/invalid
PF020102Beneficiary / Bank Details Invalid or IncompleteTax identification number is missing/invalid
PF020103Beneficiary / Bank Details Invalid or IncompleteBeneficiary name is missing/invalid
PF020104Beneficiary / Bank Details Invalid or IncompleteMissing/invalid deposit key (For example - upi handle or pix key)
PF020105Beneficiary / Bank Details Invalid or IncompleteMissing/invalid wallet deposit address
PF020106Beneficiary / Bank Details Invalid or IncompleteBank account number is missing/invalid
PF020107Beneficiary / Bank Details Invalid or IncompleteBank branch is missing/invalid
PF020108Beneficiary / Bank Details Invalid or IncompleteBank name is missing/invalid
PF020109Beneficiary / Bank Details Invalid or IncompleteIBAN is missing/invalid.
PF020200Beneficiary / Bank Details Invalid or IncompleteThe destination details do not match the beneficiary’s registered information (e.g., beneficiary name mismatch).
PF020201Beneficiary / Bank Details Invalid or IncompleteThe beneficiary name does not match the beneficiary’s registered name.
PF020202Beneficiary / Bank Details Invalid or IncompleteThe beneficiary tax id does not match the beneficiary’s registered tax id.
PF020203Beneficiary / Bank Details Invalid or IncompleteThe beneficiary receiving currency does not match the bank account currency.
PF020300Beneficiary / Bank Details Invalid or IncompleteThe receiving bank is not supported
PF020400Beneficiary / Bank Details Invalid or IncompleteThe specified account type is missing or not supported.
PF020500Beneficiary / Bank Details Invalid or IncompleteDestination account is blocked/closed or not supported
PF020600Beneficiary / Bank Details Invalid or IncompleteBeneficiary address is invalid
PF030000Bank / Network Failure or RejectionsA general error occurred due to beneficiary bank or network rejection/failure
PF030100Bank / Network Failure or RejectionsBeneficiary bank rejected incoming funds
PF030101Bank / Network Failure or RejectionsBeneficiary bank rejected incoming funds as foreign inward remittance is not allowed.
PF030102Bank / Network Failure or RejectionsBeneficiary bank rejected incoming funds as payout amount is above the allowed amount for account type.
PF030103Bank / Network Failure or RejectionsBeneficiary bank rejected incoming funds as the bank/account does not allow the indicated payout transfer type
PF030104Bank / Network Failure or RejectionsBeneficiary bank does not support the fund transfer network
PF030200Bank / Network Failure or RejectionsFund transfer network rejected transfer of funds
PF030300Bank / Network Failure or RejectionsFunds were returned by the beneficiary bank
PF030400Bank / Network Failure or RejectionsTransaction failed due to beneficiary bank technical issue
PF030500Bank / Network Failure or RejectionsTransaction failed due to beneficiary bank cut off limit
PF040000Compliance / AML / Fraud / Risk ControlsPayout is flagged for compliance/Fraud/AML risks; may violate regulations or Tazapay policies.
PF040100Compliance / AML / Fraud / Risk ControlsRemitter/Beneficiary failed compliance check (individual/business is blocked/ineligible to make/receive payments)
PF040101Compliance / AML / Fraud / Risk ControlsRemitter failed compliance check (individual/business is blocked/ineligible to make payments)
PF040102Compliance / AML / Fraud / Risk ControlsBeneficiary failed compliance check (individual/business is blocked/ineligible to receive payments)
PF040103Compliance / AML / Fraud / Risk ControlsBeneficiary name does not align with the beneficiary type.
PF040104Compliance / AML / Fraud / Risk ControlsRemitter name does not align with the remitter type.
PF040105Compliance / AML / Fraud / Risk ControlsBeneficiary details consists of restricted keywords
PF040106Compliance / AML / Fraud / Risk ControlsRemitter details consists of restricted keywords
PF040200Compliance / AML / Fraud / Risk ControlsThe payout was created on behalf of an entity that has been rejected
PF060000RFIA general error occurred while reviewing RFI data, preventing payout approval.
PF060100RFISubmitted RFI documents were missing required fields, improperly formatted, or failed validation checks.
PF060200RFIThe submitted RFI data contained inconsistencies or conflicts with previously provided information.
PF060300RFIOne or more uploaded documents were expired or no longer valid at the time of review.
PF060400RFIThe payment was rejected after manual compliance review of the RFI submission.
PF060500RFIUnable to continue with the payment due to an existing RFI on the remitter data.
PF060600RFIThe RFI response or review was not completed within the required time window.
PF070000Remitter Details Invalid or IncompleteA generic error occurred during remitter details validation.
PF070100Remitter Details Invalid or IncompleteRemitter address is missing/invalid.
PF070200Remitter Details Invalid or IncompleteFund transfer network is not enabled for remitter