Send a PayPal batch payout to multiple recipients using the Payouts API

domain: paypal.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Obtain an access token via POST /v1/oauth2/token with your client credentials using Basic Auth.
  2. Construct a batch payout body with sender_batch_header (sender_batch_id for idempotency, email_subject, recipient_type) and a list of items each containing receiver, amount, and note.
  3. Submit the batch via POST /v1/payments/payouts; save the returned payout_batch_id.
  4. Poll the batch status via GET /v1/payments/payouts/{payout_batch_id} until batch_status is 'SUCCESS' or 'DENIED'.
  5. For individual item failures, inspect each payout item's transaction_status and errors array; re-queue failed items with corrected data.
  6. Subscribe to PAYMENT.PAYOUTSBATCH.DENIED and PAYMENT.PAYOUTS-ITEM.FAILED webhook events for asynchronous failure notification.

Known gotchas

Related routes

Send a batch payout to multiple recipients using the PayPal Payouts API and handle unclaimed or failed items
developer.paypal.com · 6 steps · unrated
Send batch payouts to sellers and contractors using the PayPal Payouts API
developer.paypal.com · 6 steps · unrated
Send global mass payouts to sellers and contractors via PayPal Enterprise Payouts (Hyperwallet)
developer.paypal.com · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans