Shopify App Earnings: Your Guide to Payouts, Holds, and Verification

Hey everyone,

As a Shopify migration expert and someone who keeps a close eye on the pulse of our vibrant developer community, I often see questions that really dig into the core of what makes our businesses tick. Recently, a fantastic thread popped up from @Hywpaddan asking some crucial questions about Shopify App Store payouts. It's a topic that touches every app developer, especially when you're just starting to see those first merchant payments roll in. Our community members chimed in with some fantastic insights, and I wanted to synthesize them into a clear guide for all of you.

Understanding Your Shopify App Earnings: When to Expect Your Payouts

Hywpaddan's initial questions were spot on, covering the timing of first payouts, what happens if a merchant's store freezes, and any pre-payout verification steps. Let’s break down what the community had to say.

When Will You Receive Your First Payout? The 30-Day Hold & Bi-Monthly Schedule

This is probably the most common question for new app partners, and for good reason! It’s exciting to see your app gain traction. As @Mustafa_Ali and @ahsandoesntcare clarified, there’s a specific process:

• The Initial 30-Day Hold: For a new partner’s first-time earnings on each new referral, Shopify applies a 30-day hold. This hold starts after the merchant has successfully paid their first bill for your app. So, if a merchant pays today, you’ll need to wait about a month before those specific earnings are released.
• Bi-Monthly Payouts: Once that initial 30-day hold is cleared for a merchant, your earnings for that merchant (and subsequent earnings from all merchants) then fall into Shopify’s standard bi-monthly payout schedule. Payouts are typically sent out on the 1st and 15th of each month.
• Minimum Payout Threshold: A crucial point raised by @accessify.web.app and reiterated by @ahsandoesntcare is the minimum payout threshold. If your accumulated balance is below this threshold (which you can set in your Partner Dashboard), the money won't be sent out in the current cycle. Instead, it’ll roll over to the next payout cycle until your balance meets or exceeds that minimum.

Pro Tip: Don't just estimate! As @accessify.web.app wisely suggested, you can confirm the exact status and release date for each transaction in your Partner Dashboard. This is your go-to source for real-time clarity.

What Happens to Your Earnings If a Merchant's Store Freezes?

This is a tricky one, and the community offered some really nuanced perspectives. Hywpaddan asked specifically about an instance where a merchant pays, but their store freezes about 10 days later. Will you still get your share of the payment that was already successfully charged?

Here’s the breakdown:

• Generally, Yes, if Settled: If the charge for your app subscription or purchase was successfully settled and paid by the merchant before their store froze, then those earnings generally stand. Our experts, including @accessify.web.app and @Mustafa_Ali, agreed on this point.
• Potential for Reversals: However, it’s not always a done deal. As @accessify.web.app and @ahsandoesntcare highlighted, Shopify might later refund or reverse that charge if the merchant disputes it or if other issues arise. If this happens, the corresponding earnings would be deducted from your future balance.
• Delays if Not Fully Processed: @Mustafa_Ali added an important clarification: if a merchant’s account gets frozen due to non-payment, your earnings on that subscription aren't paid out until the merchant’s account is unfrozen and the payment is successfully processed. So, while a charge that already succeeded should be honored, a store freeze can definitely introduce delays if things weren't fully settled.

The takeaway? Keep a close eye on your transaction list in the Partner Dashboard. Don't assume everything is perfectly settled until you see it confirmed there, and be prepared for potential deductions if a charge is later reversed.

First Payout Verification: What to Expect and How to Prepare

Hywpaddan's third question about additional verification before the first payout is super important, as it can definitely impact your timeline. The short answer is: yes, absolutely.

@ahsandoesntcare gave us a clear picture of what’s usually required:

1. Complete Partner Account Setup: Before your first payout, your Partner account needs to be fully set up. This isn't just about publishing your app; it's about your financial and legal standing.
2. Tax Information: You’ll need to submit and verify your tax information (like a W-8 or W-9 form, depending on your location and business type).
3. Bank Details: Your bank details must be correctly entered and verified to ensure funds can be transferred successfully.
4. Identity Verification: If your earnings start to exceed a certain threshold, Shopify may request additional identity verification. This could involve submitting government ID or official business documents.

Could it delay your first payout? Absolutely. As @ahsandoesntcare noted, incomplete or unverified details are a common cause for payout delays. @Mustafa_Ali also mentioned that while the specifics aren't always publicly documented and can vary, it's definitely something to be aware of.

Actionable Steps: Ensuring Smooth Payouts

So, what can you do to make sure your earnings land in your bank account without a hitch?

1. Proactively Complete Your Payout Settings: Head over to your Partner Dashboard > Settings > Payouts. Double-check that all your tax information and bank details are submitted, correct, and verified. Don't wait for Shopify to prompt you!
2. Monitor Your Payout Threshold: While you're in the Payouts settings, confirm your minimum payout threshold. Adjust it if needed to align with your expectations for receiving funds.
3. Track Individual Transactions: Regularly check your Partner Dashboard > Payouts to see the status and release date of each merchant transaction. This gives you the clearest picture of when specific funds become payable.
4. Watch for Deductions: Keep an eye on your transaction list for any deductions related to refunds or chargebacks, especially if you've had merchants with frozen stores or payment issues.
5. Don't Hesitate to Contact Partner Support: If your first payout is past its scheduled date, and you've verified all your details and there are no apparent holds, follow @accessify.web.app's advice: open a ticket directly with Shopify Partner Support. They can investigate specific account issues much better than anyone else.

Navigating the financial side of app development can feel a bit complex at first, but with these insights from our community, you're much better equipped. The key is proactive setup and vigilant monitoring of your Partner Dashboard. It's your central hub for all things related to your app's performance and, crucially, your earnings. Keep building amazing apps, and may your payouts be prompt and plentiful!