Tags:
- Admin GraphQL API
- 2026-01
Set and retrieve processedAt in the refundCreate mutation
processedAt in the refundCreate mutationWe have introduced a new input field to the mutation. With this field, you can manage refund timestamps in your records more effectively.
If you don't provide a value, then the current timestamp is used by default. This ensures that existing integrations continue to function without modification.
What's new
The mutation now includes an optional field, enabling you to specify the exact time a refund was processed. This feature is particularly useful for:
- Processing backdated refunds: Manage refunds initiated offline or those that need to reflect a specific processing date for accounting purposes.
- Maintaining accurate financial records: Ensure your refund timestamps align with your actual business operations and reporting periods.
How it works
To use this feature, include the field when creating a refund:
mutation refundCreate($input: RefundInput!) {
refundCreate(input: $input) {
refund {
id
processedAt
createdAt
}
userErrors {
field
message
}
}
}
With input:
{
"input": {
"orderId": "gid://shopify/Order/123",
"processedAt": "2024-12-01T10:30:00Z",
"refundLineItems": [...]
}
}
If you don't provide a value, the current timestamp is used by default. This ensures that existing integrations continue to function without modification.
Was this section helpful?