Shopify adds merchant-only notes to store credit transactions

Shopify now lets apps attach merchant-only notes to store credit transactions through GraphQL Admin API version 2027-01. Developers can add an optional note when crediting or debiting a store credit account, then read that note on the resulting transaction.

The StoreCreditAccountCreditInput and StoreCreditAccountDebitInput types accept a new optional note string. The StoreCreditAccountTransaction type exposes a note field that returns the stored value for credit, debit, and debit-revert transactions, or null when no note is set. Expiration transactions always return null. Notes can be up to 5,000 characters. Longer notes return a NOTE_TOO_LONG user error, and the API does not create the transaction. Notes can be set when a transaction is created but cannot be edited afterward. They are visible only to merchants, not customers.

No new access scope is required. The existing read_store_credit_account_transactions and write_store_credit_account_transactions scopes and their permission requirements still apply. Versions 2026-10 and earlier do not expose these fields.

Why it matters

Store credit adjustments often need internal context, such as why a credit was issued or why a balance was corrected. Storing that context on the transaction itself keeps the record in one place. Because notes are optional and merchant-only, the change adds useful detail without affecting what customers see.

What to do

Existing integrations do not need changes. To use notes, target API version 2027-01 or later, include a note in your credit or debit input, and select note on the returned transaction. Test the change on a dev store by creating a transaction with a note and confirming the response includes the expected string. Review the storeCreditAccountCredit and storeCreditAccountDebit mutation references on Shopify’s developer site for complete details.