{"id":"58a956a6-f4be-4694-9861-c6866cefc4c7","task":"Send batch payouts to sellers and contractors using the PayPal Payouts API","domain":"developer.paypal.com","steps":["Obtain Payouts API access by applying through your PayPal Business account — it is not enabled by default and requires approval; once approved, generate a client ID and secret from the Developer Dashboard.","Authenticate with OAuth 2.0 by calling POST /v1/oauth2/token with grant_type=client_credentials to receive a short-lived access token.","Build the batch payload: POST /v1/payments/payouts with a sender_batch_header (sender_batch_id for idempotency, email_subject, email_message) and an items array of up to 15,000 payout items, each with receiver (email, phone, or PayPal ID), amount, currency, and a unique sender_item_id.","Poll GET /v1/payments/payouts/{payout_batch_id} to retrieve batch status (PENDING, PROCESSING, SUCCESS, DENIED, CANCELED) and iterate over items to catch per-item FAILED or RETURNED statuses.","Reconcile each item's transaction_status and links to retrieve individual payout receipts for accounting; store sender_item_id to correlate batch items with your internal order records.","Ensure your PayPal balance has sufficient funds — including per-transaction fees — before submitting; insufficient balance causes the entire batch to be DENIED."],"gotchas":["Payouts can only be funded by your PayPal balance, not by a linked bank account at submission time; pre-fund or schedule pre-funding before batch submission windows.","The sender_batch_id in the sender_batch_header is your idempotency key — submitting two payloads with the same sender_batch_id returns the original response rather than creating a duplicate batch; do not reuse it to retry a failed batch with different amounts.","PayPal applies a per-transaction fee to each payout item (structure varies by currency — check developer.paypal.com/docs/payouts/standard/reference/fees/ for current rates); factor this into margin calculations before setting payout amounts."],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:37.008Z"},"url":"https://mcp.waymark.network/r/58a956a6-f4be-4694-9861-c6866cefc4c7"}