Payouts

This guide explains how to receive your earnings from CodeLibra, including setting up payout methods, understanding fees, and configuring automatic payouts.

When Funds Become Available

License revenue goes through several stages before you can withdraw it:

Purchase: A licensee completes payment
Processing: Payment is verified and credited to your account
Hold period: 14-day hold while the refund window is open
Available: Funds are ready for payout

The 14-day hold protects against chargebacks and refunds. After this period, you can request a payout at any time.

Setting Up Payouts

Step 1: Complete Verification

Before receiving payouts, you'll need to:

Verify your identity (required by payment regulations)
Provide accurate tax information
Confirm your organization details

This is a one-time process handled through your account settings.

Step 2: Connect a Payout Method

Go to your organization settings and navigate to Payouts or Payout Connections.

Available payout methods:

Bank transfer (ACH for U.S., international wire for other countries)
Other methods may be available depending on your region

You can connect multiple payout methods if desired.

Step 3: Choose Your Payout Approach

Manual payouts: Request a payout whenever you want, for any amount above the minimum.

Automatic payouts: Configure CodeLibra to automatically pay out when your balance reaches a threshold.

Manual Payouts

Requesting a Payout

Go to your organization's Account or Payouts section
View your available balance
Enter the amount to withdraw
Select your payout method
Confirm the request

Minimum Payout Amount

The minimum payout amount is typically $50. Payouts below this threshold incur a small processing fee (see Fees below).

Processing Time

Payout processing typically takes 1-3 business days, depending on your payout method and location.

Automatic Payouts

Configure automatic payouts to receive regular payments without manual action.

Configuration Options

Frequency: How often to check for payouts

Weekly
Monthly
Custom schedule

Minimum balance: Only trigger a payout when your balance reaches this amount (must be at least the free payout threshold, typically $50)

Account floor: Optionally keep a minimum balance in your account (the payout will be reduced to maintain this floor)

How It Works

When automatic payout runs:

System checks if your available balance meets the minimum
If yes, calculates payout amount (balance minus account floor, if set)
If amount qualifies for free payout, initiates transfer
If amount would incur fees, skips until balance grows (or you manually request)

Example Configuration

Minimum balance: $100
Account floor: $25
Frequency: Monthly

Each month, if your available balance is $100+, CodeLibra automatically pays out your balance minus $25.

Fees

Free Payouts

Payouts of $50 or more have no processing fee.

Small Payout Fee

For payouts under $50:

Fee: $0.25 + 0.25% of the payout amount

Example: A $20 payout would incur a fee of $0.25 + $0.05 = $0.30, so you'd receive $19.70.

Currency Conversion

If you receive payouts in a currency other than U.S. dollars:

Conversion is handled by the payment processor
Exchange rates are the processor's rates at time of transfer
No additional CodeLibra fee for conversion

No Other Fees

There are no monthly fees, account maintenance fees, or hidden charges.

Payout Timing

Hold Periods

Standard hold: 14 days after purchase
Hold extensions: May apply if there are disputes, fraud concerns, or policy issues

Bank Processing

After CodeLibra initiates a payout:

ACH (U.S.): 1-2 business days
International wire: 2-5 business days
Actual timing depends on your bank

Payout Schedule

Manual payouts: Process on the next business day
Automatic payouts: Process according to your configured frequency

Viewing Payout History

Your dashboard shows:

Pending payouts: Requested but not yet completed
Completed payouts: Successfully transferred
Failed payouts: If there was an issue (rare)

For each payout:

Amount requested
Fees deducted
Net amount received
Payout method used
Status and dates

When Payouts May Be Held

In some cases, payouts may be delayed:

Pending refund requests: If a subscriber has requested a refund, related revenue may be held until resolved.

Incomplete documentation: If required verification documents are missing or expired.

Fraud investigation: If there are concerns about potentially fraudulent transactions.

Policy violations: If there are unresolved issues with your account or modules.

You'll be notified if any holds apply to your account.

Tax Reporting

What CodeLibra Provides

Transaction history with revenue details
Annual earnings summaries
Tax forms as required by law (e.g., Form 1099-K for U.S. developers earning above thresholds)

Your Responsibilities

You are responsible for:

Reporting income to appropriate tax authorities
Understanding tax obligations in your jurisdiction
Maintaining your own records
Consulting tax professionals as needed

CodeLibra reports gross earnings. Fees and expenses are separate from this reporting.

Troubleshooting

Payout Failed

Common reasons:

Incorrect bank details
Bank rejected the transfer
Account closed or restricted

Solution: Verify your payout method details and try again. If issues persist, contact support.

Funds Not Available

Common reasons:

Still within 14-day hold period
Pending refund or dispute
Documentation issue

Solution: Check your dashboard for specific hold reasons or contact support.

Payout Method Not Working

Solution:

Remove the problematic payout method
Re-add it with verified details
Test with a small payout if concerned

Missing Payouts

If a payout shows as completed but you haven't received it:

Allow full processing time (up to 5 business days)
Check with your bank
Verify the payout details were correct
Contact support with transaction ID

Best Practices

Keep Details Current

Update your payout information if:

Bank accounts change
Address changes
Tax information changes

Monitor Your Account

Regularly check:

Available balance
Pending transactions
Any hold notifications

Plan for Taxes

Set aside a portion of earnings for tax obligations. Consider quarterly estimated payments if required in your jurisdiction.

Use Automatic Payouts

Once you have consistent revenue, automatic payouts reduce administrative overhead and ensure regular cash flow.

Common Questions

Is there a maximum payout amount?

Large payouts may require additional verification but there's no hard maximum for legitimate transactions.

Can I split payouts between multiple accounts?

Not automatically. You would need to request separate payouts manually.

What if I'm in a country where payouts aren't supported?

Payout availability depends on your location. Check your account settings for available options. If no options are available, funds accumulate until support is added.

Do I need to provide tax forms before receiving payouts?

Tax information may be required before payouts depending on your location and earnings. You'll be prompted during setup.

Next Steps

Revenue Sharing — Understand how revenue is calculated
Setting Prices — Pricing to maximize earnings
Getting Started — Overview of the developer experience