Reference

Fees & money flows

Exactly what PayPal holds, captures, pays out, voids and refunds, with worked numbers.

The fee

2.5% of the money that's actually released, taken as it's released. Nothing on refunds, nothing monthly. The fee is computed on the cumulative amount released, so splitting a payment into milestones never costs more than paying it at once.

The hold includes the most the fee could ever be, so the money for the fee is never in question.

Terms: $100 when the promise starts, $200 when the final logo is accepted, everything back if nothing arrives within 7 days.

StepDecided by the rulesWhat PayPal does
Fund$300 heldAuthorization of $307.50 ($300 + at most $7.50 fee)
Start$100 to the designerCapture $102.50 from the hold; pay out $100 to the designer
Logo accepted$200 to the designerCapture $205.00; pay out $200
SettledDesigner $300, client $0 back, fee $7.50Nothing left on the hold

If nothing arrives on time instead:

StepDecided by the rulesWhat PayPal does
Start$100 to the designerCapture $102.50; pay out $100
Deadline passes$200 back to the clientVoid the remaining $205.00 of the hold
SettledDesigner $100, client $200 back, fee $2.50The client was only ever charged $102.50

Funding modes

ModeWhenHow money is held
AuthorizePromises that finish within 28 daysAn authorization on the payer's PayPal. Partial captures as rules release; a void for the rest.
EscrowLonger promisesCaptured up front into escrow. Payouts as rules release; refunds for the rest.

PayPal honors an authorization for 3 days and lets it be reauthorized up to day 29. Kept reauthorizes just in time, and if a hold is about to expire with money still promised, an expiry guard captures the remainder into escrow a day early so no promise can lapse.

Every number, before you sign

The verifier derives bounds for every promise before anyone pays:

BoundLogo example
Payee receives$100 to $300
Payer gets back$0 to $200
Fee$2.50 to $7.50
Latest settlementhour 360
PayPal calls, worst case9
Distinct endings3

They're shown on every promise as chips, and returned by the API in verification.report.bounds.

Agent budgets

The hold is the budget plus the most the fee could be. Each approved purchase captures the amount plus its fee and pays the merchant. When the budget closes, the unused hold is voided.

Improve this page on GitHub