View reports and transaction logs
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.
Activity report
Activity report provides the list of all the transaction activity for your PayPal business account.
- Log in to your PayPal business account.
- Go to Activity > Reports > All reports.
- On the All reports page, select Activities tab > Activity report.
- On the Activity report page, choose the Transaction type, Date range, and Format.
- Optional: Select Customize report fields to add or remove fields from the report.
- Select Create report. The report appears in the Activity reports list. You will get a notification when it is ready for download.
- Select Download.
You can also get the Activity report from Recent activity on your dashboard:
- Go to Recent activity > View Activity.
- On the Transactions page, select Filter.
- Choose Payouts as the Transaction type.
- Select the date range. By default, the Transactions page displays a list of the transactions from the last 30 days. You can view payout transactions for any date range in the last three years.
- Optional: Adjust other search filters.
- Select Apply filters. The search results display transaction list that match your criteria, showing:
- Date
- Type
- Name
- Subject
- Gross Amount
- Status
- Fees
- Net Amount
- Select the download icon to export the report. It redirects you to the Activity report page.
View the transaction log
- Log in to your PayPal business account.
- On the dashboard, go to Activity > Transactions > All transactions.
- On Transactions page, select the payout transaction you want to review.
- On the Mass Payment Details page, select View Details to open the BatchLog.txt dialog.
- Open or save the log file for your records. 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 Transaction log - error and reason codes.
Settlements report and Transaction details report
You can use these reports to identify different types of payouts transactions using Transaction event codes (T-codes).
- Contact PayPal to enable report access for your PayPal business account. Only approved merchants and payment partners can access these reports.
- To track a transaction, use the Transaction ID in the PayPal Reference ID column.
- Find the type of payout transaction using the T-codes provided in Transaction Event Code column. For more information, see Transaction event codes.
Access Settlements report
- Log in to your PayPal business account.
- Go to Activity > Reports > All reports.
- In the All reports page, select Payments tab > Settlements report.
- Set date range and filters.
- Download the report as a CSV or TSV file.
For more information, see the Settlement Report Specification.
Access Transaction details report
- Log in to your PayPal business account.
- Go to Activity > Reports > All reports.
- In the All reports page, select Payments tab > Transaction details report.
- Download the report as a CSV or TSV file.
For more information, see the Transaction Detail Report Specification.
Transaction event codes
Transaction event codes (T-codes) identifies the type of payout transactions in your reports. For payouts, T-codes help you monitor payout transactions at every step.
T-code | Description |
---|---|
T0001 | Mass Payment (successful) |
T0104 | Mass Payment batch fee |
T1105 | Account hold released |
T1114 | Mass Payment reversal transaction |
T1115 | Mass Payment refund transaction |
T1503 | Temporary hold on payout amount and fees |
For example:
- When you initiate a payout,
T1503
indicates that PayPal places a temporary hold on the payout amount and associated fees. - When the batch payout completes, T-code changes to
T1105
. This indicates that PayPal released the hold on funds. If any payments are declined, your final balance may be higher than during the hold.
Stage reports for large-batch file transfer
PayPal provides the stage reports for payouts made through large-batch file transfer.
To access these reports:
- Connect to the DropZone SFTP server using your credentials.
- Go to the
Outgoing
folder on PayPal's DropZone SFTP server. - Download the report files in CSV format.
Reference
Transaction log - error and reason codes
The following errors may occur when PayPal processes your payouts. After you fix the errors, retry the payout.
Reason | Error code | Description |
---|---|---|
400 | ITEM_ALREADY_CANCELLED | Requested item is already cancelled. |
400 | ITEM_CANCELLATION_FAILED | Requested item is already cancelled. |
400 | ITEM_INCORRECT_STATUS | You can only cancel items that are in UNCLAIMED state. |
400 | USER_BUSINESS_ERROR | A business error occurred for the user. |
403 | REQUIRED_SCOPE_MISSING | Access token does not have the required scope. |
403 | SENDER_ACCOUNT_UNVERIFIED | Verify 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. |
429 | RATE_LIMIT_VALIDATION_FAILURES | Request is blocked due to multiple failed attempts. Try again later. |
504 | REQUEST_TIMEOUT_EXCEEDED | System did not respond within the timeout period. Try again later. |
1000 | UNDEFINED | An error occurred while processing this payout request. Try again later or make a new request. |
1002 | INSUFFICIENT_FUNDS | To complete the payout transaction, add money to your account. |
1003 | USER_COUNTRY_NOT_ALLOWED | Payouts not allowed in the country mentioned in your address. For assistance, contact your account manager or customer support. |
1004 | USER_FUNDING_SOURCE_INELIGIBLE | Funding source for this transaction is not allowed. Try again using your PayPal balance. |
1005 | PENDING_RECIPIENT_NON_HOLDING_CURRENCY_PAYMENT_PREFERENCE | Transaction 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. |
3004 | SELF_PAY_NOT_ALLOWED | You cannot send a payout to yourself. Try sending it to a different account. |
3014 | SENDER_ACCOUNT_LOCKED | Account locked or inactive. Cannot send a payout now, For assistance, contact your account manager or customer support. |
3015 | RECEIVER_ACCOUNT_LOCKED | Recipient's account locked or inactive. Cannot send a Payouts now. Money returned to your account. |
3017 | SPENDING_LIMIT_EXCEEDED | Exceeded your spending limit. For assistance, contact your account manager or customer support. |
3047 | ACCOUNT_RESTRICTED | Restricted account access. For assistance, contact your account manager or customer support. |
3078 | NEGATIVE_BALANCE | Insufficient amount in your PayPal balance. Add funds to your account to complete the payout. |
3107 | REFUSED_RECEIVER_REFUSED | Recipient refused payout in this currency. Try resending in a different currency. |
3141 | REFUSED_ACTION_DENIED | Access denied as the send money option is not allowed for this merchant. |
3148 | RECEIVER_COUNTRY_NOT_ALLOWED | PayPal cannot send this payout because the recipient lives in a country where Payouts are not allowed. |
3501 | INVALID_EMAIL_ID | Email ID entered for this recipient is invalid. |
3547 | SENDER_STATE_RESTRICTED | Cannot send this transaction since your address is in a restricted state. |
3558 | RECEIVER_STATE_RESTRICTED | Cannot send this transaction because the recipient lives in a state where Payouts are not allowed. |
3769 | CLOSED_MARKET | Account is not allowed to receive Payouts from other countries. Try resending this payout to another account. |
4002 | INTERNAL_ERROR | Internal error occurred during payout request processing. Retry this payout as a new batch or file. |
8304 | ACCOUNT_UNCONFIRMED_EMAIL | Verify 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. |
8319 | ZERO_AMOUNT | Provide a valid payment amount. |
8330 | RECEIVING_LIMIT_EXCEEDED | Recipient cannot accept this Payouts because it exceeds the amount they can receive at this time. Resubmit your payout request for a different amount. |
8331 | DUPLICATE_ITEM | Duplicate transaction in the batch. Check the reference ID and sender ID. |
9302 | RISK_DECLINE | Transaction declined due to risk concerns. |
9500 | GAMER_FAILED_COUNTRY_OF_RESIDENCE_CHECK | Recipient lives in a country that is not allowed to accept this Payouts transaction. |
9501 | GAMER_FAILED_FUNDING_SOURCE_CHECK | Funding source that was selected for this payout is not allowed. Try again using your PayPal balance. |
9502 | GAMING_INVALID_PAYMENT_FLOW | Payment flow is not allowed for gaming merchant accounts. |
11711 | TRANSACTION_LIMIT_EXCEEDED | Payouts request exceeds the limit for this type of transaction. The money has been returned to your account. |
14159 | CURRENCY_NOT_SUPPORTED_FOR_RECEIVER | Recipient's account does not support this currency. Resend this payout with a different currency. |
14550 | CURRENCY_COMPLIANCE | Transaction not allowed, due to currency compliance regulations. |
14763 | REGULATORY_PENDING | Transaction is pending while it is reviewed for compliance with government regulations. |
14764 | REGULATORY_BLOCKED | Transaction blocked due to regulatory compliance restrictions. |
14765 | RECEIVER_UNREGISTERED | Recipient 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. |
14766 | RECEIVER_UNCONFIRMED | Recipient'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. |
14767 | RECEIVER_YOUTH_ACCOUNT | Unable to send Payouts because the recipient has a youth account. Check with the recipient for an alternate account to receive the money. |
14776 | TRANSACTION_DECLINED_BY_TRAVEL_RULE | An 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. |
14800 | POS_LIMIT_EXCEEDED | You have exceeded the POS cumulative spending limit. For assistance, contact your account manager or customer support. |
14801 | UNVERIFIED_RECIPIENT_NOT_SUPPORTED | Payout request incomplete because of unverified recipient account. Your account can send Payouts only to verified accounts. |
14802 | NON_HOLDING_CURRENCY | No 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. |