Confirm the store is on API version 2024-07 or later, as StoreCreditAccount launched in that version
Query the customer's StoreCreditAccount using the storeCreditAccount field on the Customer object to obtain the account ID
Use the storeCreditAccountCredit mutation (not storeCreditAccountCreditCreate, which does not exist) to add credit to the account
Pass the amount, currency, and a reference to the originating order or refund in the mutation variables
Confirm the mutation returns a storeCreditAccountCreditTransaction with the new balance
Record the transaction ID for reconciliation and customer communication
Known gotchas
StoreCreditAccount and the storeCreditAccountCredit mutation are only available from API version 2024-07 onward; earlier versions return a field-not-found error
There is no mutation called customerCreditAccountCreditCreate; using that name will fail schema validation
Store credit is currency-specific; crediting in a different currency than the customer's default may require additional handling
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp