Show payout batch details
GET {{base_url}}/v1/payments/payouts/:payout_batch_id
Shows the latest status of a batch payout. Includes the transaction status and other data for individual payout items.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
fields | string | Shows details for only the specified fields. | |
page | number | A non-zero integer representing the page of the results. | |
page_size | number | The maximum number of results to return at one time. Value is a non-negative, non-zero integer. If the user chooses pagination, the maximum page is 1000. | |
total_required | boolean | Indicates whether to show the total items and total pages count in the response. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | The Content-Type header field is used to specify the nature of the data in the body of an entity. PayPal REST APIs support application/json. | |
PayPal-Request-Id | string | The server stores keys for 6 hours. The API callers can request the times to up to 72 hours by speaking to their Account Manager. | |
PayPal-Client-Metadata-Id | string | Optional. Verifies that the payment originates from a valid, user-consented device and application. Reduces fraud and decreases declines. Transactions that do not include a client metadata ID are not eligible for PayPal Seller Protection. | |
PayPal-Partner-Attribution-Id | string | Optional. Identifies the caller as a PayPal partner. To receive revenue attribution, specify a unique build notation (BN) code. BN codes provide tracking on all transactions that originate or are associated with a particular partner. To find your BN code, see Code and Credential Reference. | |
PayPal-Auth-Assertion | string | An API client-provided JSON Web Token (JWT) assertion that identifies the merchant. To use this header, you must get consent to act on behalf of a merchant. | |
Prefer | string | The preferred server response upon successful completion of the request. Value is:<ul><li><code>return=minimal</code>. The server returns a minimal response to optimize communication between the API caller and the server. A minimal response includes the <code>id</code>, <code>status</code> and HATEOAS links.</li><li><code>return=representation</code>. The server returns a complete resource representation, including the current state of the resource.</li></ul> | |
Prefer | string | The preferred server response upon successful completion of the request. Value is:<ul><li><code>return=minimal</code>. The server returns a minimal response to optimize communication between the API caller and the server. A minimal response includes the <code>id</code>, <code>status</code> and HATEOAS links.</li><li><code>return=representation</code>. The server returns a complete resource representation, including the current state of the resource.</li></ul> |
RESPONSES
status: OK
{"batch_header":{"payout_batch_id":"42WWRAXUXYSQQ","batch_status":"SUCCESS","time_created":"2022-02-02T06:46:08Z","time_completed":"2022-02-02T06:46:09Z","sender_batch_header":{"sender_batch_id":"Payouts_1643784368","email_subject":"You have a payout!","email_message":"You have received a payout! Thanks for using our service!"},"funding_source":"BALANCE","amount":{"currency":"USD","value":"60.00"},"fees":{"currency":"USD","value":"0.50"}},"items":[{"payout_item_id":"4FNYP6JKEW28S","transaction_id":"7S520406M51625248","activity_id":"9MA543628Y061272E","transaction_status":"UNCLAIMED","payout_item_fee":{"currency":"USD","value":"0.25"},"payout_batch_id":"42WWRAXUXYSQQ","payout_item":{"recipient_type":"EMAIL","amount":{"currency":"USD","value":"10.00"},"note":"Thanks for your patronage!","receiver":"Barry4@yahoo.com","sender_item_id":"201403140001","recipient_wallet":"PAYPAL"},"time_processed":"2022-02-02T06:46:09Z","errors":{"name":"RECEIVER_UNREGISTERED","message":"The recipient for this payout does not have an account. A link to sign up for an account was sent to the recipient. However, if the recipient does not claim this payout within 30 days, the funds will be returned to your account.","information_link":"https://developer.paypal.com/docs/api/payments.payouts-batch/#errors","details":[],"links":[]},"links":[{"href":"https://api.sandbox.paypal.com/v1/payments/payouts-item/4FNYP6JKEW28S","rel":"item","method":"GET","encType":"application/json"}]},{"payout_item_id":"99YK5EH7CZUAW","transaction_id":"2CV76751DK2174928","activity_id":"5CA91533SU8358159","transaction_status":"UNCLAIMED","payout_item_fee":{"currency":"USD","value":"0.25"},"payout_batch_id":"42WWRAXUXYSQQ","payout_item":{"recipient_type":"PHONE","amount":{"currency":"USD","value":"20.00"},"note":"Thanks for your support!","receiver":"17949325275","sender_item_id":"201403140002","recipient_wallet":"PAYPAL"},"time_processed":"2022-02-02T06:46:09Z","errors":{"name":"RECEIVER_UNREGISTERED","message":"The recipient for this payout does not have an account. A link to sign up for an account was sent to the recipient. However, if the recipient does not claim this payout within 30 days, the funds will be returned to your account.","information_link":"https://developer.paypal.com/docs/api/payments.payouts-batch/#errors","details":[],"links":[]},"links":[{"href":"https://api.sandbox.paypal.com/v1/payments/payouts-item/99YK5EH7CZUAW","rel":"item","method":"GET","encType":"application/json"}]},{"payout_item_id":"U3XM6R2489GUC","transaction_status":"FAILED","payout_item_fee":{"currency":"USD","value":"0.00"},"payout_batch_id":"42WWRAXUXYSQQ","payout_item":{"recipient_type":"PAYPAL_ID","amount":{"currency":"USD","value":"30.00"},"note":"Thanks for your patronage!","receiver":"G83KXTJ5EHCQ2","sender_item_id":"201403140003","recipient_wallet":"PAYPAL"},"errors":{"name":"RECEIVER_ACCOUNT_INVALID","message":"Receiver's account is invalid","information_link":"https://developer.paypal.com/docs/api/payments.payouts-batch/#errors","details":[],"links":[]},"links":[{"href":"https://api.sandbox.paypal.com/v1/payments/payouts-item/U3XM6R2489GUC","rel":"item","method":"GET","encType":"application/json"}]}],"links":[{"href":"https://api.sandbox.paypal.com/v1/payments/payouts/42WWRAXUXYSQQ?page_size=1000\u0026page=1","rel":"self","method":"GET","encType":"application/json"}]}