Shopify Adds USDC Credit Field to Payments Payout GraphQL in 2025

What Changed

Shopify has expanded the GraphQL Admin API with a new field for tracking cryptocurrency rebate credits. As of API version 2025-10, the ShopifyPaymentsPayoutSummary object now includes a usdcRebateCreditAmount field that displays the total value of all USDC rebate credits issued within a payout. This addition makes it easier for developers to monitor stablecoin incentive programs directly through the GraphQL API.

Why This Matters

For developers building financial reporting tools, accounting integrations, or custom payout dashboards, access to granular payout data is essential. This new field enables more complete visibility into all forms of merchant credits and rebates, including those distributed in USDC. As cryptocurrency payments and incentive programs become more prevalent in e-commerce, having native API support for these data points reduces the need for manual reconciliation or third-party workarounds.

What You Should Do

Update your GraphQL queries targeting the ShopifyPaymentsPayoutSummary object to request the new usdcRebateCreditAmount field for complete payout visibility
Review your existing payout reporting logic to ensure it accounts for USDC credits separately if your business model requires distinguishing between fiat and cryptocurrency rebates
Migrate to GraphQL Admin API version 2025-10 or later to access this field; check Shopify.dev documentation for detailed schema information and any breaking changes

How GetShopifyToken Helps

If you're building applications that need reliable access to Shopify's GraphQL API, GetShopifyToken streamlines OAuth authentication and token management. We handle the credential flow so you can focus on querying payout data and building powerful financial features for your merchants.

← More Shopify Updates