Skip to main content

​
Overview

Payouts are the actual payments made to partners for their earned commissions. Partnero supports multiple payout methods and can automate the entire process.

​
Payout Methods

PayPal

Mass payouts via PayPal

Wise

International transfers via Wise

Manual

Manual bank transfers

Store Credit

Issue as account credits

​
Payout Settings

​
Minimum Payout Threshold

Set a minimum balance before partners can request payouts: 
{
  "minimum_payout": 50,
  "currency": "USD"
}

​
Payout Schedule

Configure automatic payout schedules:
ScheduleDescription
ManualAdmins trigger payouts
WeeklyEvery week on specified day
Bi-weeklyEvery two weeks
MonthlyOn specified day of month

​
Payout Hold Period

Hold commissions for a period before making them payable (for refund protection): 
{
  "hold_period": 30, // days
  "description": "30-day hold for refund protection"
}

​
Partner Payout Settings

Partners configure their payout preferences in the portal:

​
PayPal

{
  "payout_method": "paypal",
  "paypal_email": "[email protected]"
}

​
Wise

{
  "payout_method": "wise",
  "wise_email": "[email protected]",
  "currency": "EUR"
}

​
Bank Transfer

{
  "payout_method": "bank_transfer",
  "bank_details": {
    "account_name": "John Doe",
    "iban": "DE89370400440532013000",
    "swift": "COBADEFFXXX"
  }
}

​
Processing Payouts

​
View Pending Payouts

See all partners with payable balances:
  1. Go to Payouts in your dashboard
  2. Review partners with balances above minimum threshold
  3. Select partners to pay

​
Initiate Payout

  1. Navigate to Payouts → Pending
  2. Select partners or “Select All”
  3. Click Process Payouts
  4. Review and confirm

​
Automatic Payouts

Enable automatic payouts with connected payment providers:
  1. Connect PayPal or Wise integration
  2. Go to Program Settings → Payouts
  3. Enable Automatic Payouts
  4. Set schedule (weekly, monthly, etc.)

​
Partner Balance

​
Check Partner Balance

View a partner’s current balance: 
# For affiliate partners
curl -X GET https://api.partnero.com/v1/partners/partner_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

# For referral customers  
curl -X GET https://api.partnero.com/v1/customers/cust_123/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Credit Partner Balance

Add a manual credit to a partner’s balance: 
curl -X POST https://api.partnero.com/v1/customers/cust_123/balance/credit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25,
    "currency": "USD",
    "note": "Bonus for reaching milestone"
  }'

​
Payout History

​
View Payout History

Track all processed payouts:
  1. Go to Payouts → History
  2. Filter by date range, partner, or status
  3. Export for accounting

​
Payout Statuses

StatusDescription
pendingPayout initiated, processing
completedPayment successfully sent
failedPayment failed (retry needed)
cancelledPayout was cancelled

​
Tax Considerations

​
Collecting Tax Information

Require partners to submit tax information:
  • W-9 (US partners)
  • W-8BEN (International partners)
  • VAT registration (EU partners)

​
1099 Reporting

For US partners earning over $600/year:
  1. Export payout data for the tax year
  2. Generate 1099-MISC forms
  3. File with IRS and send to partners
Consult with a tax professional for compliance requirements in your jurisdiction.

​
Best Practices

Set minimum payout thresholds to reduce transaction fees and administrative overhead. 50−50-100 is common.
Implement 30-60 day hold periods to protect against refunds and chargebacks.
Clearly communicate payout schedules and requirements to partners.
Maintain detailed payout records for accounting and tax purposes.

​
Next Steps

PayPal Setup

Configure PayPal payouts

Wise Setup

Configure Wise payouts