Seller payouts are disabled by default. Do not enable them until the operator has PayPal Payouts
approval and has validated recipient, tax, sanctions, recovery, and reconciliation procedures.
The standard deployment has no automatic payout schedule, promised arrival time, or published
payout fee. A saved bank account is only a future destination and submitting seller verification
does not move money.
What is implemented
- Customer payments, refunds, and disputes are processed through the central PayPal account.
- Each successful order updates the organization’s internal seller-payable ledger.
- Seller verification collects identity and Indian bank details for review.
- Finance exposes the transactions behind the payable for reconciliation.
- A feature-gated PayPal Payouts integration can create idempotent payout attempts, reconcile item
webhooks, retry eligible failures, and record the fee actually returned by PayPal.
What is not implemented
- Bank-account ownership verification through a banking partner
- Sending money to the saved Indian bank account
- Treating an arbitrary external transfer as a reconciled OurPay payout
- Automatic tax withholding, payout tax forms, or tax filing
The backend rejects PayPal payout-account creation while payouts are disabled. Enabling central
PayPal collection is not a workaround: PayPal Orders and PayPal Payouts are separate products.
Feature-gated PayPal payouts
Set OURPAY_PAYPAL_PAYOUTS_ENABLED=true only after PayPal has enabled Payouts for the operator
account. A payout goes to the email or other recipient identifier saved on the PayPal payout
account; it does not use the saved bank destination.
OurPay cannot know the exact payout fee before PayPal processes the item, so it does not estimate
or silently absorb one. When PayPal returns payout_item_fee, OurPay records a processor-fee
transaction and an equal seller-ledger debit. Repeated webhooks and reconciliation runs use the
PayPal payout item ID to avoid charging the same fee twice. Because the fee is known after the
transfer starts, it can appear as a post-payout Seller Payable adjustment and reduce a later payout.
If PayPal returns, refunds, reverses, blocks, denies, or cancels an item, OurPay releases the
reserved payout back to Seller Payable exactly once. A fee remains seller-paid only when PayPal
actually reports it. Retryable failures stay reserved while OurPay retries them; after the configured
attempt limit, OurPay releases the payout instead of leaving the seller balance locked.
Manual transfers during this phase
The deployment operator may decide to settle a seller externally, but that is an operational action
outside the current OurPay payout lifecycle. If you do this:
- Verify the seller and destination under your own compliance process.
- Reconcile the exact currency and amount against the organization’s ledger.
- Retain transfer evidence and any required tax documentation.
- Account for the fact that OurPay will still show the original payable until a supported payout
record is introduced.
Do not promise that a manual transfer is tracked, reversible, or protected by OurPay. Refunds and
disputes can reduce the seller’s eventual entitlement after the original sale.
Payout boundary
The payout rail remains separate from payment acceptance. It creates an auditable payout
transaction, reduces Seller Payable exactly once, tracks attempts and failures, and preserves the
connection to original ledger entries. Finance continues to label the amount Seller Payable
because provider availability, post-payout fees, refunds, and disputes can still change it.
See Seller verification and bank details for the information currently
collected and Seller payable and fees for the ledger calculation.