The PayPal Payouts API solves a specific problem: paying multiple recipients via PayPal programmatically, without logging into the PayPal dashboard for each payment. Marketplace sellers receiving their share of a sale, affiliates receiving commission, contractors receiving payment, gig economy workers receiving earnings — if recipients have PayPal accounts and expect to be paid via PayPal, the Payouts API automates the entire disbursement process. This post covers how the Payouts API works, what it costs, when it’s the right choice, and what the integration involves.
What the PayPal Payouts API does
The Payouts API sends money from your PayPal Business account to one or more recipient PayPal accounts in a single API call. You specify a list of recipients — identified by their PayPal email address or PayPal account ID — with the amount for each. PayPal processes the payouts and delivers the funds to each recipient’s PayPal balance. Recipients are notified by PayPal email that they’ve received a payment.
Payouts can be sent individually (one API call, one recipient) or in batch (one API call, multiple recipients). Batch payouts are more efficient for high-volume disbursements — weekly commission runs, monthly earnings distributions, bulk refunds. A single batch payout call can contain up to 15,000 items.
The payout processing time varies. Most payouts complete within minutes, but PayPal can take up to 24 hours to process larger batches. Your integration uses webhook events or the Payouts API status endpoint to confirm when each payout has completed or failed.
The 2% fee — what it means in practice
PayPal charges 2% of the payout amount per transaction, capped at £1 for UK GBP payouts. This fee is deducted from your PayPal balance, not from the recipient’s payment.
What this means at different payout values:
A £10 payout costs you 20p in fees. A £50 payout costs £1 (at the cap). A £100 payout costs £1 (at the cap). A £500 payout costs £1 (at the cap).
The fee cap makes PayPal Payouts reasonably cost-effective for higher-value individual payouts. For low-value high-volume payouts — paying hundreds of recipients £5–£20 each — the 2% fee per transaction adds up. A platform paying 500 recipients £15 each pays £150 in PayPal fees (2% x £15 x 500). Worth modelling against your expected volumes before committing to PayPal Payouts as the mechanism.
When PayPal Payouts is the right choice
Your recipients already use and expect PayPal. Marketplace sellers on platforms where PayPal is the established payment method, eBay sellers, Etsy sellers who receive via PayPal — these recipients expect PayPal payments. Paying them via bank transfer when they’re set up for PayPal creates friction. PayPal Payouts is the natural choice.
International recipients where PayPal is preferred. PayPal operates in over 200 countries and supports multiple currencies. For platforms paying international affiliates, contractors or sellers, PayPal often has better coverage and lower friction than bank transfer alternatives. Recipients in countries where bank-to-bank international transfers are slow or expensive often strongly prefer PayPal.
Recipients don’t want to share bank details. Some contractors and freelancers are comfortable sharing their PayPal email but reluctant to share sort code and account number with every platform they work with. PayPal Payouts removes that friction — the PayPal email is the only information needed.
When PayPal Payouts is not the right choice
Recipients don’t have or want PayPal accounts. PayPal Payouts requires the recipient to have a PayPal account. If you’re paying customers for trade-ins, UK contractors who prefer bank transfer, or any recipient group that doesn’t use PayPal, the Revolut Business API or a direct bank transfer mechanism is better. See the Revolut Business API integration for the bank transfer payout approach.
Very low value, very high volume. At 2% per payout, paying 1,000 recipients £5 each costs £100 in fees. If margins are tight and volumes are high at low values, the fee structure makes PayPal Payouts expensive relative to alternatives.
You need bank account name matching and fraud safeguards. PayPal Payouts sends to a PayPal email address — there’s no equivalent of the bank account holder name verification available in the Revolut API. For use cases where fraud prevention at the recipient validation stage is critical, bank transfer with name matching is more robust.
Production access approval for Payouts
PayPal requires a separate approval for production Payouts access. Standard PayPal Business accounts can test Payouts in sandbox but cannot use the Payouts API in production until PayPal approves the use case. The approval involves confirming your business type, the purpose of the payouts, and the expected volume.
For legitimate use cases — marketplace seller payments, affiliate commissions, contractor payouts — approval is generally granted without difficulty. The application is made through the PayPal Developer Dashboard. Approval typically takes a few days but can take longer. Apply before the integration build starts so approval isn’t on the critical path for go-live.
What the integration looks like
A Payouts integration connects your platform’s disbursement trigger to the PayPal Payouts API. When earnings are calculated — at end of day, end of week, or triggered by a specific event — your system generates a list of recipients and amounts. The integration makes a single Payouts API call with the full list. PayPal processes the batch and returns a batch ID. The integration polls the batch status endpoint or uses webhooks to confirm each individual payout has completed or failed.
Failed payouts need explicit handling. A payout to an invalid PayPal email, a PayPal account that’s been closed, or a currency mismatch will fail. The integration logs the failure, alerts your team, and holds the funds for manual reprocessing rather than silently failing. Every payout attempt — successful or failed — is logged with the recipient, amount, batch ID and outcome.
For the full service details, see the PayPal API integration service. For the complete PayPal API guide, see PayPal API integration guide. For how PayPal Payouts compares with Revolut, see the Revolut Business API service. For what the build costs, see PayPal API integration cost.
Related posts
- PayPal API integration: a complete guide
- PayPal vs Stripe: which is right for your business?
- PayPal checkout integration for custom platforms
- PayPal API integration cost
Reconciling PayPal Payouts in Xero
For businesses that use Xero alongside PayPal, payout disbursements need to be reflected correctly in the accounts. Each PayPal payout batch reduces your PayPal Business balance and eventually appears as a transfer to your bank account when PayPal settles the funds. In Xero, the PayPal balance is typically managed as a separate account — payments in increase the balance, payouts reduce it, and PayPal-to-bank transfers reconcile the bank feed.
A custom integration can create Xero journal entries or bank transactions for each payout batch automatically — logging the disbursement amount, the PayPal fees, and the individual recipient payments as line items. This removes the manual step of exporting PayPal transaction reports and importing them to Xero, and keeps the accounts current without anyone having to log into either PayPal or Xero to reconcile.
The Xero reconciliation component adds scope to the integration build but pays for itself quickly in accountancy time saved at month end. If Xero reconciliation is a requirement, confirm this during scoping so it’s included in the fixed-price quote.
Currency handling in international payouts
PayPal Payouts supports multiple currencies. You can send payouts in a recipient’s local currency from your GBP PayPal Business balance — PayPal converts at their exchange rate and applies their currency conversion fee. Alternatively, you can hold balances in multiple currencies in your PayPal Business account and send payouts in the matching currency without conversion.
For platforms paying international recipients regularly, the currency conversion fee on each payout is worth factoring into cost modelling. At 2.5% per conversion on top of the 2% payout fee, international payouts in local currencies become meaningfully more expensive than domestic GBP payouts. Holding multi-currency balances in PayPal avoids the conversion fee but requires managing the balances separately.
If you need help with a custom API integration for your website or business application, I can help. I build bespoke API integrations for UK businesses. See API integration pricing or get in touch to discuss your project.
Need a custom integration built?
I build custom API integrations — Stripe, Companies House and bespoke data pipelines. Reliable, well-documented, no agency overhead.
Discuss your project →