Payout Status Description

Each payout request submitted to the Payout API results in an item with a specific status, which reflects the current state of the payout process. These statuses help you track payout processing, understand failure reasons, and determine if a retry is possible.

These statuses are essential for tracking the delivery of funds, diagnosing failures, and triggering retries or reconciliation workflows in your system.

๐Ÿ“˜

The status field indicates the current state of the payout, such as whether itโ€™s still being processed, was successfully delivered, or failed due to an issue. This value may change over time as the payout moves through its lifecycle.

Payout Lifecycle

  • PENDING: The payout has been received and will be processed shortly.
  • SUCCESS: The payout was successfully processed.
  • FAILED: The payout was rejected due to a failure. The possible reasons are described in the table below.
  • REVERSED: The payout was reversed by the end user or the destination financial institution.

๐Ÿ“˜

A payout can transition from SUCCESS to REVERSED if the transaction is recalled by the end user or blocked by the financial institution.

๐Ÿ“˜

Reversal Policy (Brazil Only)

If a payout reaches REVERSED status, it means the amount has been returned by the destination bank or user.

  • Applies only to PIX and BANK TRANSFER.
  • A reversal can occur up to 90 days after payment.
  • Reversal can be partial or full.

Payout Statuses

The table below outlines all possible statuses a payout item can receive, their meanings, and whether retry attempts are allowed.

CodeReasonPayment MethodDescriptionRetry Allowed
PENDINGโ€“AllPayout item was received and will be processed soon.โ€“
SUCCESSโ€“AllPayout was processed successfully. Funds were delivered to the recipient.โ€“
FAILEDPROCESSING_ERRORAllAn unexpected error occurred during processing.โœ…
FAILEDINVALID_DESTINATIONAllThe PIX key or bank account is invalid.โŒ
FAILEDINSUFFICIENT_FUNDSAllInsufficient funds to process the payout.โŒ
FAILEDPAYEE_IRREGULAR_REGISTERAllPayee failed compliance verification with PagSeguro policies.โŒ
FAILEDPAYOUT_DENIEDAllPayout could not be processed for internal or regulatory reasons.โŒ
FAILEDPAYEE_NAME_DOES_NOT_MATCHAllPayee name did not meet the minimum match threshold with the document. Use the exact name on the document and avoid special characters.โŒ
FAILEDPAYEE_LEGAL_CONSTRAINTSAllThe payee is restricted due to legal or international compliance requirements.โŒ
FAILEDPAYEE_DECEASEDAllThe CPF or CNPJ is associated with a deceased individual.โŒ
FAILEDPAYEE_UNDERAGEDAllPayee is under 18 and cannot receive payouts (especially in regulated sectors such as betting).โŒ
FAILEDPAYEE_EXCEEDED_FINANCIAL_LIMITAllThe recipient has exceeded their allowed financial transaction limit.โŒ
FAILEDREJECTED_BY_RECEIVERPIX / Bank TransferPayout was rejected by the receiving financial institution.โŒ
FAILEDPROCESSING_TIMEOUTPIX / Bank TransferTimeout occurred in the SPI (Brazilโ€™s instant payment system).โœ…
FAILEDDESTINATION_NOT_MATCH_DOCUMENTPIX / Bank TransferAccount ownerโ€™s name does not match the document provided.โŒ
FAILEDDESTINATION_ACCOUNT_BLOCKEDPagBankThe recipientโ€™s account is blocked.โŒ
FAILEDPAYEE_NATIONAL_ID_CANCELLEDAllThe national ID (CPF/CNPJ) has been administratively cancelled.โŒ
FAILEDPAYEE_NATIONAL_ID_INACTIVEAllThe national ID (CPF/CNPJ) is inactive or no longer valid.โŒ
FAILEDSALARY_ACCOUNT_TYPE_UNSUPPORTEDPIX / Bank TransferSalary-type accounts are not accepted for payouts.โŒ
FAILEDPAYEE_TYPE_NOT_ACCEPTEDPIX / Bank TransferThe payeeโ€™s legal classification is not supported by the payout method.โŒ
REVERSEDREJECTED_BY_PAYEEPIX / BANK TRANSFERTransfer was rejected by payee.โŒ
REVERSEDREJECTED_BY_PAYEE_BANKPIX / BANK TRANSFERTransfer was rejected by payee bank.โŒ