Sipariş iadesi oluşturma
suggestedRefund ile iade tutarını hesaplayın, ardından refundCreate ve bir idempotency key ile ürünleri iade edin, stoğa alın ve ödemeyi geri gönderin.
- API
- Admin GraphQL API
- İşlemler
- order.suggestedRefund, refundCreate
- Erişim yetkisi
- write_orders
- Yerini aldığı REST çağrısı
- POST /admin/api/orders/{id}/refunds/calculate.json ve POST /admin/api/orders/{id}/refunds.json
- API sürümü
- 2026-10
- Son kontrol
Kısaca
Bir siparişi iade etmek için önce order.suggestedRefund ile tutarı ve iadenin yapılacağı işlemi (transaction) öğrenin, ardından refundCreate’i refundLineItems (restockType ve lokasyonla) ve transactions (parentId, gateway, kind REFUND, amount) ile çağırın. 2026-04 API sürümünden itibaren refundCreate bir @idempotent anahtarı ister; böylece tekrar denenen bir istek iki kez iade yapamaz.
Nasıl kullanılır
- CalculateRefund’u iade edilecek satırlar ve adetlerle gönderin. Kargo ücretini dışarıda bırakın ya da onu da iade etmek için refundShipping’i açın.
- Önerilen işlemin gateway, tutar ve parent transaction ID’sini kind REFUND ile iade girdisine kopyalayın.
- Ürünleri stoğa geri almak için restockType RETURN (locationId ile), almamak için NO_RESTOCK seçin.
- RefundItem’ı yeni bir idempotency key ile gönderin. Zaman aşımından sonra tekrar denerken aynı anahtarı kullanın.
Kod
suggested-refund.graphqlquery CalculateRefund($orderId: ID!, $refundLineItems: [RefundLineItemInput!]) {
order(id: $orderId) {
id
suggestedRefund(refundLineItems: $refundLineItems, refundShipping: false) {
amountSet {
shopMoney {
amount
currencyCode
}
}
suggestedTransactions {
gateway
kind
amountSet {
shopMoney {
amount
}
}
parentTransaction {
id
}
}
}
}
}
suggested-refund.variables.json{
"orderId": "gid://shopify/Order/1234567890",
"refundLineItems": [
{"lineItemId": "gid://shopify/LineItem/1111111111", "quantity": 1}
]
}
suggested-refund.response.json{
"data": {
"order": {
"id": "gid://shopify/Order/1234567890",
"suggestedRefund": {
"amountSet": {
"shopMoney": {
"amount": "49.00",
"currencyCode": "EUR"
}
},
"suggestedTransactions": [
{
"gateway": "shopify_payments",
"kind": "SUGGESTED_REFUND",
"amountSet": {"shopMoney": {"amount": "49.00"}},
"parentTransaction": {"id": "gid://shopify/OrderTransaction/2222222222"}
}
]
}
}
}
}
refund-create.graphqlmutation RefundItem($input: RefundInput!, $idempotencyKey: String!) {
refundCreate(input: $input) @idempotent(key: $idempotencyKey) {
refund {
id
totalRefundedSet {
shopMoney {
amount
currencyCode
}
}
}
userErrors {
field
message
}
}
}
refund-create.variables.json{
"idempotencyKey": "3b8f6c1d-9a2e-4c7b-8d5f-1e2a3b4c5d6e",
"input": {
"orderId": "gid://shopify/Order/1234567890",
"note": "Returned: size too small",
"notify": true,
"refundLineItems": [
{
"lineItemId": "gid://shopify/LineItem/1111111111",
"quantity": 1,
"restockType": "RETURN",
"locationId": "gid://shopify/Location/1234567890"
}
],
"transactions": [
{
"orderId": "gid://shopify/Order/1234567890",
"parentId": "gid://shopify/OrderTransaction/2222222222",
"gateway": "shopify_payments",
"kind": "REFUND",
"amount": "49.00"
}
]
}
}
refund-create.response.json{
"data": {
"refundCreate": {
"refund": {
"id": "gid://shopify/Refund/1234567890",
"totalRefundedSet": {
"shopMoney": {
"amount": "49.00",
"currencyCode": "EUR"
}
}
},
"userErrors": []
}
}
}
Lintel tarafından yazıldı. MIT lisansı: kendi mağazanızda da müşteri işlerinizde de ücretsiz kullanabilirsiniz.
Sınırlar ve özel durumlar
- Boş bir transactions listesi, para iadesi yapmadan iade edilen ürünleri kaydeder ve stoğa alır.
- Varsayılanı false olan allowOverRefunding, toplam iadenin ödenen tutarı aşıp aşamayacağını belirler.
- returnRefund, returns API ile oluşturulmuş bir iadenin parasal kısmını yönetir; refundCreate ise satır bazında stoğa alma ayarı da sunar.
- 60 günden eski siparişler için ayrıca read_all_orders gerekir.
Sık sorulan sorular
- GraphQL ile bir Shopify siparişi nasıl iade edilir?
- refundCreate’i sipariş ID’si, iade edilecek satırlar ve orijinal ödemeye karşı bir REFUND işlemiyle, @idempotent anahtarıyla birlikte çağırın.
- İade tutarını önceden nasıl hesaplarım?
- Aynı satırlarla order.suggestedRefund’u sorgulayın. Tutarı, vergileri ve kullanılacak önerilen işlemleri döndürür.
- Stoğa almadan iade yapabilir miyim?
- Evet. Her iade satırında restockType’ı NO_RESTOCK yapın.
Shopify belgeleri
- Gösterilen tarihte, 2026-10 sürümünün Admin veya Storefront API şemasıyla doğrulandı. İstek adresinizdeki sürümü kontrol edin.
- Örneklerdeki ID’ler ve mağaza adresleri yer tutucudur. Kendi değerlerinizle değiştirin.
- Admin API çağrıları uygulamanızdan bir erişim anahtarı (access token) ister. Admin API anahtarını asla vitrine ya da temaya koymayın.
- MIT lisansı. Kodu kendi mağazanızda da müşteri işlerinizde de kullanabilirsiniz.
Mağazanız için kurulmasını, test edilmesini ve bakımını isterseniz: API entegrasyonları.
