Refund discrepancy issue

GraphQL Admin API Troubleshooting
1

Hi,

I want to know, why Shopify is not adding “Refund Discrepancy” when return order is refunded using “ProcessReturn” graphql? but same is being populated in order if I do the refund using “refundCreate” api.

Clarification: we cannot use refundCreate api to do the refund, as when there is multiple quantity and partial quantity is returned than during refund it process refund against the fulfilled order line item id not against the return order, so its preventing user to create return order of remaining item.

2

Hey @Maulik_Shah_RAB - thanks for reaching out.

I did some testing on the behaviour you’re describing, and I couldn’t reproduce. On a partial under-refund, both returnProcess and refundCreate produced the order adjustment for me, with the reason coming back as REFUND_DISCREPANCY.

What decides whether the adjustment shows up is whether there’s an actual gap between the suggested refund amount and what was refunded. If a return ends up refunded for the full suggested amount, there’s nothing to record, so no adjustment is created. That can make returnProcess look like it’s skipping it, when the reason is that the numbers balanced out.

To see what’s different in your case, it’d help to look at a specific example. Could you share a shop ID and the order ID where you saw returnProcess not create the adjustment? If you’d rather not post those publicly, I’m happy to set up a DM and you can send them over that way.

Hope this helps!

3

Hi

When we do refundCreate we have input of reason for discrepancy, which is not their in returnProcess

image
image1149×484 34.8 KB

Reference order id: 7017061089570

{ "returns": {
                "nodes": [
                     {
                        "id": "gid://shopify/Return/15123611938",
                        "status": "CLOSED",
                        "createdAt": "2026-06-01T08:39:07Z",
                        "refunds": {
                            "nodes": [
                                {
                                    "orderAdjustments": {
                                        "nodes": []
                                    },
                                    "totalRefundedSet": {
                                        "presentmentMoney": {
                                            "amount": "171.0"
                                        }
                                    }
                                }
                            ]
                        },
                        "returnShippingFees": [
                            {
                                "amountSet": {
                                    "presentmentMoney": {
                                        "amount": "79.0"
                                    }
                                }
                            }
                        ],
                        "returnLineItems": {
                            "nodes": [
                                {
                                    "id": "gid://shopify/ReturnLineItem/23619240226",
                                    "quantity": 1,
                                    "refundableQuantity": 0,
                                    "refundedQuantity": 1,
                                    "returnReason": "OTHER",
                                    "returnReasonNote": "OTHER",
                                    "customerNote": null,
                                    "fulfillmentLineItem": {
                                        "id": "gid://shopify/FulfillmentLineItem/14757043700002",
                                        "lineItem": {
                                            "id": "gid://shopify/LineItem/17015731159330",
                                            "name": "Short sleeved T-Shirt - Small / Red",
                                            "sku": "1119",
                                            "originalUnitPriceSet": {
                                                "presentmentMoney": {
                                                    "amount": "250.0"
                                                }
                                            }
                                        }
                                    }
                                }
                            ],
                            "pageInfo": {
                                "startCursor": "eyJsYXN0X2lkIjoyMzYxOTI0MDIyNiwibGFzdF92YWx1ZSI6MjM2MTkyNDAyMjZ9",
                                "endCursor": "eyJsYXN0X2lkIjoyMzYxOTI0MDIyNiwibGFzdF92YWx1ZSI6MjM2MTkyNDAyMjZ9",
                                "hasNextPage": false,
                                "hasPreviousPage": false
                            }
                        }
                    }
                ]
            },
 "refundDiscrepancySet": {
                "presentmentMoney": {
                    "amount": "0.0",
                    "currencyCode": "SEK"
                }
            },
"transactions": [
                {
                    "id": "gid://shopify/OrderTransaction/8660303118626",
                    "kind": "SALE",
                    "status": "SUCCESS",
                    "createdAt": "2026-06-01T08:29:52Z",
                    "amountSet": {
                        "presentmentMoney": {
                            "amount": "514.0",
                            "currencyCode": "SEK"
                        },
                        "shopMoney": {
                            "amount": "514.0",
                            "currencyCode": "SEK"
                        }
                    }
                },
                {
                    "id": "gid://shopify/OrderTransaction/8660315865378",
                    "kind": "REFUND",
                    "status": "SUCCESS",
                    "createdAt": "2026-06-01T08:39:14Z",
                    "amountSet": {
                        "presentmentMoney": {
                            "amount": "171.0",
                            "currencyCode": "SEK"
                        },
                        "shopMoney": {
                            "amount": "171.0",
                            "currencyCode": "SEK"
                        }
                    }
                }
            ]
}

here in above example if you notice, total refund amount is 250; but after deducting shipping fees of 79, the final refund is 171. Still there no refund order adjustment is being generated. This order is refunded using returnProcess, if I do the refund with refundCreate, it display refundOrderAdjustment entries.

4

Thanks for the additional context @Maulik_Shah_RAB.

Can you please share either the shop ID or an x-request-id of your returnProcess call you shared above? I’m not able to trace this in our logs to investigate the specifics with only the order ID.

5

@Wes-Dev-Shopify I think i got what you are trying to suggest in first post. Problem is fixed and got the understanding.

Thanks