Shopify App Payouts Demystified: Your Guide to Getting Paid on Time

Hey everyone! It's your friendly Shopify migration expert here, and today we're diving into a super important topic for all you app developers out there: getting paid! We recently had a fantastic discussion pop up in the community, started by @Hywpaddan, asking some really crucial questions about Shopify App Store payouts. It's clear these are common concerns, so let's break down what the community shared and what you need to know to ensure your earnings land in your bank account smoothly.

Hywpaddan kicked things off with three key questions:

1. When to expect the first payout after merchants start paying for an app.
2. What happens to earnings if a merchant's store freezes after a successful payment.
3. Whether additional verification is needed before the first payout.

The community jumped in with some excellent insights, and I've synthesized them into a clear guide for you.

Your First Payout: The 30-Day Dance and Beyond

This is probably the most common question for new app partners. It's exciting to see those first installations and paid plans, but when does the money actually hit your account? The short answer, as @Mustafa_Ali and @ahsandoesntcare pointed out, involves a couple of key factors:

1. The Initial 30-Day Hold

Straight from Shopify's Partner earnings documentation, there's a standard 30-day hold applied to your first-time earnings for each new referral. This means that after a merchant successfully pays their first bill for your app, Shopify holds onto those earnings for about a month. This period helps ensure the payment is solid and no immediate issues arise.

2. The Bi-Monthly Payout Schedule

Once that 30-day hold is up, your earnings then fall into Shopify's regular payout schedule. Payouts are typically processed twice a month: on the 1st and 15th. So, the exact timing of your first payout really depends on when that 30-day hold ends relative to these bi-monthly dates.

3. Don't Forget the Minimum Payout Threshold!

An important detail @accessify.web.app highlighted is your minimum payout threshold. You can find this in your Partner Dashboard under your Payout settings. If your accumulated balance is below this threshold, your money won't be sent out; instead, it'll simply roll over to the next payout cycle until you hit that minimum. Always keep an eye on this!

Pro Tip: Check Your Partner Dashboard

To get the most accurate picture, @accessify.web.app wisely suggested heading to your Partner Dashboard > Payouts. Here, you can actually see the status and release date for each individual transaction, giving you a precise idea of when specific merchant earnings become payable.

The Curious Case of Frozen Stores: Will Your Earnings Stick?

This is a tricky one, and Hywpaddan's second question perfectly captures the anxiety around it. What happens if a merchant pays for your app, but their store gets frozen shortly after?

The general consensus from the community is reassuring, but with a crucial caveat:

• If the charge was successfully settled before the freeze: Both @Mustafa_Ali and @accessify.web.app confirmed that a charge that has already been successfully processed and settled before a store freeze generally stands. Your earnings from that specific, completed transaction should still be honored.
• The "But" – Refunds and Reversals: Here's where you need to be vigilant. As @accessify.web.app pointed out, "if Shopify later refunds or reverses that charge, the corresponding earnings are deducted from your balance." So, while the initial payment might seem secure, keep an eye on your transaction list for any deductions. @ahsandoesntcare echoed this, stating that only "successfully settled charges count; any later refunds or chargebacks are deducted from future payouts."
• Delays for Unfrozen Accounts: @Mustafa_Ali also noted that if a merchant's account gets frozen due to non-payment, any earnings on that subscription/purchase might not be paid out until the merchant's account is unfrozen and the payment is successfully processed. So, while a prior successful charge might be safe, ongoing earnings could be on hold.

The takeaway: For a payment that already went through, you're likely good. But always monitor your transactions because Shopify can reverse charges, which would then affect your balance.

First Payout Verification: What to Expect

Hywpaddan's final question about additional verification before the first payout is super important, as it can definitely impact your timeline.

@ahsandoesntcare laid out the essential steps:

1. Complete Partner Account Setup: Before your first payout, your Partner account needs to be fully set up. This isn't just about your app; it's about your business as a partner.
2. Tax Information: You absolutely must submit and verify your tax information (like a W-8 or W-9, depending on your location). This is non-negotiable for any platform paying you.
3. Bank Details: Your bank account details need to be accurately submitted and verified. Shopify needs to know where to send your money!
4. Identity Verification: @ahsandoesntcare mentioned that "Shopify may also request identity verification (e.g., government ID or business documents) if your earnings exceed a threshold." This is a common practice to comply with financial regulations and prevent fraud, especially as your earnings grow.

The bottom line: Incomplete details will absolutely delay your payouts until everything is resolved. So, be proactive and get all your ducks in a row in the Partner Dashboard > Settings > Payouts well before your first payout is due.

When in Doubt, Contact Partner Support

@Mustafa_Ali noted that the specifics of additional verification aren't always publicly documented and can vary. If you're unsure, or if your first payout is past its scheduled date with all details verified and no holds, both @Mustafa_Ali and @accessify.web.app strongly recommended opening a ticket directly with Shopify Partner Support. They can give you the most accurate and up-to-date information for your specific situation.

So there you have it! Navigating app payouts on Shopify can seem a bit complex at first, but by understanding the 30-day hold, the bi-monthly schedule, keeping an eye on your minimum threshold, and ensuring all your verification details are complete, you'll be well on your way to receiving your hard-earned cash. Don't hesitate to use your Partner Dashboard as your go-to source for transaction statuses, and remember, Shopify Partner Support is always there if you hit a snag. Happy developing!