Why is the Payouts API returning a 404 error?

Topic summary

Payouts API calls to /admin/api/2023-04/shopify_payments/payouts.json are returning 404 Not Found despite correct shop name, API version, endpoint, and scopes.

  • Confirmed checks: shop name is valid (other endpoints work), scopes like read_shopify_payments_payouts or shopify_payments_payouts are set, and headers/token are present. A concrete request/response log shows a 404 from a valid shop domain.
  • Key insight: Multiple users report this occurs on sandbox/test stores with no Shopify Payments payout data. The endpoint appears to return 404 when there are no payouts, rather than 200 with an empty array .
  • Scope notes: One user used shopify_payments_payouts and could not add shopify_payments without errors; others report identical behavior even with correct scopes.

Outcome/Status:

  • No official fix or workaround shared. Community consensus is that the 404 is tied to test stores lacking payout data.
  • Open questions: How to mock payouts in a sandbox/test store and whether Shopify will change the behavior to return 200 with empty results.
Summarized with AI on December 28. AI used: gpt-5.

I’m running into the same thing, any updates here, were you able to work around it?

1 Like