Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paypal.ai/llms.txt

Use this file to discover all available pages before exploring further.

You can access the reports and transaction logs for payouts using your PayPal business account. These reports help you monitor, download, and analyze payout activity for reconciliation, compliance, and troubleshooting.

​
Generate Activity report

You can use the Activity report to get a list of all the transaction activity for your PayPal business account.
  1. Log into your PayPal business account.
  2. Go to Activity > All reports.
  3. On the All reports page, select Activities tab > Activity report.
  4. On the Activity report page, choose the Transaction type, Date range, and Format.
  5. Optional: Select Customize report fields to add or remove fields from the report.
  6. Select Create report. The report appears in the Activity reports list. You will receive a notification when it is ready for download.
  7. Select Download. The report contains the transaction details such as Date, Name, Status, Transaction ID, Fee, and so on.

​
Generate Settlements report and Transaction details report

You can use the Settlements report and Transaction details report to identify different types of payout transactions using Transaction event codes.

​
Understand transaction event codes

You can use the Transaction event codes (T-codes) to identify the type of payout transactions in your reports. For payouts, T-codes help you monitor payout transactions at every step.
T-codeDescription
T0001Mass Payment (successful)
T0104Mass Payment batch fee
T1105Account hold released
T1114Mass Payment reversal transaction
T1115Mass Payment refund transaction
T1503Temporary hold on payout amount and fees
For example:
  • T1503: When you start a payout, PayPal assigns this code to the transaction and places a temporary hold on the payout amount and associated fees.
  • T1105: When the batch payout completes, PayPal changes the T-code to this value and releases the hold on the payout amount. If PayPal declines any payments, your final balance may be higher than during the hold.

​
Generate Settlements report

You can use the Settlements report to view a summary of transactions that affect your PayPal balance. It includes details of sent and refunded payouts but excludes declined payments.
  1. Contact PayPal to enable the Settlements report access for your PayPal business account.
  2. After you get the report access, log into your PayPal business account.
  3. Go to Activity > All reports.
  4. On the All reports page, select Payments tab > Settlements report.
  5. Set the date range and filters.
  6. Download the report as a .csv or .tsv file.
  7. In the downloaded report, you can:
    • Use the Transaction ID from the Activity report to filter the PayPal Reference ID column and track specific transactions.
    • Use the T-codes in the Transaction Event Code column to find the type of payout transaction. For more information about T-codes, see Understand transaction event codes.
For more information, see the Settlement Report Specification.

​
Generate Transaction details report

You can use the Transaction details report to view a summary of transactions that affect your PayPal balance. It includes details of all payout transactions but excludes declined payments.
  1. Contact PayPal to enable the Transaction details report access for your PayPal business account.
  2. After you get the report access, log into your PayPal business account.
  3. Go to Activity > All reports.
  4. On the All reports page, select Payments tab > Transaction details report.
  5. Download the report as a .csv or .tsv file.
  6. In the downloaded report, you can:
    • Use the Transaction ID from the Activity report to filter the PayPal Reference ID column and track specific transactions.
    • Use the T-codes in the Transaction Event Code column to find the type of payout transaction. For more information about T-codes, see Understand transaction event codes.
For more information, see the Transaction Detail Report Specification.

​
Access stage reports for large-batch file transfer

PayPal provides the stage reports for payouts made through large-batch file transfer. To access these reports:
  1. Connect to the DropZone SFTP server using your credentials.
  2. Go to the Outgoing folder on PayPal’s DropZone SFTP server.
  3. Download the report files in .csv format.

​
View transaction log

  1. Log into your PayPal business account.
  2. You can view the transaction log using one of these ways:
    • Go to Activity > All transactions.
    • From the dashboard, go to Recent activity section > select View Activity.
  3. On Transactions page, select Filter.
  4. Choose Payouts as the Transaction type.
  5. Select the date range. By default, the Transactions page displays a list of transactions from last 30 days. You can view payout transactions for any date range in the last three years.
  6. Optional: Adjust other search filters.
  7. Select Apply filters. The search results display transaction list that matches your criteria, showing:
    • Date
    • Type
    • Name
    • Status
    • Gross Amount
    • Fee
    • Net Amount
  8. Select the payout transaction you want to review.
  9. On the Transaction details page, you can review the payout details.
  10. Select Download (CSV) or Download (TXT) to download the payment log and view all the individual payment details. If the payout required currency conversion, the log includes the exchange rate, fee, and total amount in both currencies.
Transaction logs also include error and reason codes. For more information, see Review error and reason codes.

​
Review error and reason codes

The following errors may occur when PayPal processes your payouts. After you review and fix the errors, retry the payout.
ReasonError codeDescription
400ITEM_ALREADY_CANCELLEDRequested item is already cancelled.
400ITEM_CANCELLATION_FAILEDRequested item is already cancelled.
400ITEM_INCORRECT_STATUSYou can only cancel items that are in UNCLAIMED state.
400USER_BUSINESS_ERRORA business error occurred for the user.
403REQUIRED_SCOPE_MISSINGAccess token does not have the required scope.
403SENDER_ACCOUNT_UNVERIFIEDVerify your account to send a payout. To verify your account, confirm your bank account or credit card. For assistance, contact your account manager or customer support.
429RATE_LIMIT_VALIDATION_FAILURESRequest blocked due to multiple failed attempts. Try again later.
504REQUEST_TIMEOUT_EXCEEDEDSystem did not respond within the timeout period. Try again later.
1000UNDEFINEDAn error occurred while processing this payout request. Try again later or make a new request.
1002INSUFFICIENT_FUNDSTo complete the payout transaction, add money to your account.
1003USER_COUNTRY_NOT_ALLOWEDPayouts not allowed in the country mentioned in your address. For assistance, contact your account manager or customer support.
1004USER_FUNDING_SOURCE_INELIGIBLEFunding source for this transaction is not allowed. Try again using your PayPal balance.
1005PENDING_RECIPIENT_NON_HOLDING_CURRENCY_PAYMENT_PREFERENCETransaction is pending because the recipient has set their account preferences to review credits in this currency. PayPal has notified the recipient. Check the payout status later.
3004SELF_PAY_NOT_ALLOWEDYou cannot send a payout to yourself. Try sending it to a different account.
3014SENDER_ACCOUNT_LOCKEDAccount locked or inactive. Cannot send a payout now, For assistance, contact your account manager or customer support.
3015RECEIVER_ACCOUNT_LOCKEDRecipient’s account locked or inactive. Cannot send a Payouts now. Money returned to your account.
3017SPENDING_LIMIT_EXCEEDEDExceeded your spending limit. For assistance, contact your account manager or customer support.
3047ACCOUNT_RESTRICTEDRestricted account access. For assistance, contact your account manager or customer support.
3078NEGATIVE_BALANCEInsufficient amount in your PayPal balance. Add funds to your account to complete the payout.
3107REFUSED_RECEIVER_REFUSEDRecipient refused payout in this currency. Try resending in a different currency.
3141REFUSED_ACTION_DENIEDAccess denied. This merchant cannot use the send money option.
3148RECEIVER_COUNTRY_NOT_ALLOWEDPayPal cannot send this payout because the recipient lives in a country where Payouts are not allowed.
3501INVALID_EMAIL_IDEmail ID entered for this recipient is invalid.
3547SENDER_STATE_RESTRICTEDCannot send this transaction since your address is in a restricted state.
3558RECEIVER_STATE_RESTRICTEDCannot send this transaction because the recipient lives in a state where Payouts are not allowed.
3769CLOSED_MARKETAccount is not allowed to receive Payouts from other countries. Try resending this payout to another account.
4002INTERNAL_ERRORInternal error occurred during payout request processing. Retry this payout as a new batch or file.
8304ACCOUNT_UNCONFIRMED_EMAILVerify your PayPal account to send Payouts. To verify your account, confirm your email and your bank account or credit card. For assistance, contact your account manager or customer support.
8319ZERO_AMOUNTProvide a valid payment amount.
8330RECEIVING_LIMIT_EXCEEDEDRecipient cannot accept this Payouts because it exceeds the amount they can receive at this time. Resubmit your payout request for a different amount.
8331DUPLICATE_ITEMDuplicate transaction in the batch. Check the reference ID and sender ID.
9302RISK_DECLINETransaction declined due to risk concerns.
9500GAMER_FAILED_COUNTRY_OF_RESIDENCE_CHECKRecipient lives in a country that is not allowed to accept this Payouts transaction.
9501GAMER_FAILED_FUNDING_SOURCE_CHECKFunding source that was selected for this payout is not allowed. Try again using your PayPal balance.
9502GAMING_INVALID_PAYMENT_FLOWPayment flow is not allowed for gaming merchant accounts.
11711TRANSACTION_LIMIT_EXCEEDEDPayouts request exceeds the limit for this type of transaction. The money has been returned to your account.
14159CURRENCY_NOT_SUPPORTED_FOR_RECEIVERRecipient’s account does not support this currency. Resend this payout with a different currency.
14550CURRENCY_COMPLIANCETransaction not allowed, due to currency compliance regulations.
14763REGULATORY_PENDINGTransaction is pending while it is reviewed for compliance with government regulations.
14764REGULATORY_BLOCKEDTransaction blocked due to regulatory compliance restrictions.
14765RECEIVER_UNREGISTEREDRecipient for this payout does not have an account. Sent a sign up link to the recipient. However, if the recipient does not claim this Payouts amount within 30 days, money returns to your account.
14766RECEIVER_UNCONFIRMEDRecipient’s email or phone number is unconfirmed. Until the recipient confirms their account information, payments made to this account will be marked UNCLAIMED. Money will be returned to your account if they are not claimed within 30 days.
14767RECEIVER_YOUTH_ACCOUNTUnable to send Payouts because the recipient has a youth account. Check with the recipient for an alternate account to receive the money.
14776TRANSACTION_DECLINED_BY_TRAVEL_RULEAn error occurred while processing this payout request. Try resending as part of a new request or file later. For assistance, contact your account manager or customer support.
14800POS_LIMIT_EXCEEDEDYou have exceeded the POS cumulative spending limit. For assistance, contact your account manager or customer support.
14801UNVERIFIED_RECIPIENT_NOT_SUPPORTEDPayout request incomplete because of unverified recipient account. Your account can send Payouts only to verified accounts.
14802NON_HOLDING_CURRENCYNo PayPal balance in this currency. Try again with a currency that has money in your PayPal account, or change your account settings to this currency.