Track payout item status

You can track the status of the individual payout items in a payout batch.

1. Use a valid access token and send a GET request to /v1/payments/payouts/{id}.
   Path parameter: id is the payout batch ID returned as part of the Create payout batch response.
   Response: On successful processing, PayPal returns the payout_item_id for all items in the payout batch.
2. Use a valid access token and send a GET request to /v1/payments/payouts-item/{payout_item_id}. Path parameter: payout_item_id is the payout item ID returned in the previous step.
   Response: On successful processing, PayPal returns the transaction_status of the payout item.

The following table summarizes the various values of transaction_status and what they mean:

Status	Description
PENDING	PayPal processes your payout. The recipient receives the money after processing.
SUCCESS	PayPal credits money to the recipient’s account.
UNCLAIMED	The recipient does not have a PayPal or Venmo account. PayPal sends a signup link, and the payout status remains unclaimed until claimed or returned.
REFUNDED	The recipient refunds the payout. PayPal returns the money to your account.
FAILED	The payout fails. PayPal does not deduct money from your account.
ON_HOLD	PayPal reviews the payout. The payout stays temporarily on hold.
BLOCKED	PayPal blocks the payout request.
DENIED	PayPal denies the payout. PayPal does not deduct money from your account.
RETURNED	PayPal returns the money to your account. This happens if the recipient does not claim the payout or you cancel it.

Sample request

curl -v -X GET https://api-m.sandbox.paypal.com/v1/payments/payouts-item/8AELMXH8UB2P8 \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS-TOKEN>'