Shop Cash sipariş verileri ve üçüncü taraf entegrasyonlar

Bir müşteri bir siparişte Shop Cash kullandığında, Shop Cash bir ödeme yöntemi olarak ele alınır. İndirim, hediye kartı veya mağaza kredisi değildir. Kalan sipariş bakiyesi Shop Pay veya Shop Pay Taksitli Alışveriş ile ödenir.

Örneğin, bir müşteri 100 USD tutarındaki bir siparişte 25 USD tutarında Shop Cash kullanırsa sipariş 25 USD tutarında bir Shop Cash ödemesi ve 75 USD tutarında bir Shop Pay ödemesi içerir. Sipariş verileriniz aynı sipariş için birden fazla ödeme yöntemi içerebilir.

Shop Cash, ağ geçidi değerlerinin mevcut olduğu yerlerde shop_cash ağ geçidi değerine sahip bir sipariş işlemi olarak görünür. Shop Cash işlemi; yetkilendirme, tahsilat, geçersiz kılma ve para iadesi gibi standart işlem yaşam döngüsünü izler. Shop Cash birleşik satış işlemi türünü kullanmaz.

Müşteri bir Shop Campaigns kapsamındaki bir Shop teklifini de kullanırsa kampanya tarafından finanse edilen değer aynı shop_cash sipariş işlemi tutarına dahil edilir. Alıcı bakiyesi ile kampanya tarafından finanse edilen kısımlar ayrı sipariş işlemleri olarak temsil edilmez. Ocak 2026 itibarıyla kampanya maliyetleri ödemelerinizden düşülmek yerine Shopify faturanızda ücretlendirilecektir; bu nedenle ödeme etkinliğindeki kampanya faturalandırma işlemleri yalnızca o tarihten önce yürütülen kampanyalar için geçerlidir. Daha fazla bilgi için Ücretler, Shop Campaigns ve Shop Cash bölümüne bakın.

Siparişleri, işlemleri, ödemeleri, gönderimleri, para iadelerini veya iadeleri içe aktaran üçüncü taraf sistemlerin Shop Cash'i bir ödeme yöntemi olarak tanıması gerekir. Bir sistem Shop Cash'i tanımazsa Shop Cash içeren siparişler içe aktarılamayabilir, eksik ödeme verileriyle içe aktarılabilir veya manuel eşleme gerektirebilir.

Üçüncü taraf sistem sağlayıcınızla aşağıdaki gereksinimleri inceleyin:

• Sistem, bir siparişte birden fazla ödeme yöntemini destekleyebilir.
• Sistem shop_cash değerini bir ödeme yöntemi olarak eşleyebilir.
• Sistem; Shop Cash'i indirim, hediye kartı veya mağaza kredisi olarak değerlendirmez.
• Sistem; her bir Shop Cash yetkilendirme, tahsilat, geçersiz kılma ve para iadesi işlemi için sipariş işlemi kimliğini (ID) depolar.
• Değer sistemin içe aktardığı verilerde yer alıyorsa sistem, tam Shop Cash yetkilendirme değerini kırpmadan depolar.
• Sistem yetkilendirme değerlerini opak dizeler olarak değerlendirir ve bunları ayrıştırmaz, kodlarını çözmez, normalleştirmez, karma (hash) işlemine tabi tutmaz ya da bunlardan anlam çıkarmaz.
• Sistem, parayı hem Shop Pay'e hem de Shop Cash'e iade eden para iadesi işlemlerini işleyebilir.
• Sistem, Shop Cash ödeme işlemlerinin mutabakatını kart ödemesi işlemlerinden ayrı olarak sağlayabilir.
• Sistem işlemlerin belirli bir sırayla döndürüldüğünü varsaymaz.

Üçüncü taraf sisteminiz her siparişin yalnızca bir ödeme yöntemi olduğunu varsayıyorsa Shop Cash siparişlerini bu sistem üzerinden işlemeden önce sağlayıcıyla iletişime geçin.

Shop Cash işlemindeki yetkilendirme değeri, opak ve değişken uzunluklu bir dizedir. Kısa bir kart yetkilendirme kodu değildir ve insanlar tarafından okunamaz.

ERP, OMS veya başka bir üçüncü taraf sisteminiz Shop Cash yetkilendirme değerlerini içe aktarıyorsa tam değeri tam olarak sağlandığı şekilde depolayın. Mümkün olan yerlerde değişken uzunluklu veya sınırsız bir metin alanı kullanın.

Sisteminiz Shop Cash yetkilendirme değerlerini depolarken şu yönergeleri izleyin:

• Değeri 50 veya 100 karakter gibi kısa ve sabit bir uzunluğa kırpmayın.
• Değerin hiçbir bölümünü ayrıştırmayın veya bundan anlam çıkarmayın.
• Tahsilat, geçersiz kılma veya para iadesi API işlemlerine yönelik işlemleri tanımlamak için yetkilendirme değerini kullanmayın.

Kırpılmış yetkilendirme değerleri, üçüncü taraf içe aktarımlarının veya alt sistemlerdeki ERP ve OMS işlemlerinin başarısız olmasına neden olabilir.

Admin API üzerinden tahsilatları, geçersiz kılmaları ve para iadelerini desteklemek için sipariş işlemi kimliklerini ve üst işlem ilişkilerini depolayın. Admin API tahsilat ve geçersiz kılma işlemleri, yetkilendirme işlemini parentTransactionId ile tanımlar. Para iadesi işlemleri, para iadesi yapılabilir tahsilat işlemini parentId ile tanımlar.

Bir uygulama veya entegrasyon API üzerinden bir Shop Cash para iadesi gerçekleştirdiğinde söz konusu para iadesi Shop Cash yetkilendirme işlemine değil, Shop Cash tahsilat işlemine bağlı olmalıdır. Yetkilendirme işlemine karşı gerçekleştirilen para iadeleri reddedilir.

Para iadesi uygulamaları ve web kancası işleyicileri, para iadesi yapılabilir Shop Cash tahsilat işlemini tanımlamalı, bu tahsilat için kalan ve para iadesi yapılabilir tutarı hesaplamalı ve tahsilat işlemi kimliğine (ID) karşı para iadesini oluşturmalıdır.

Admin API, sipariş dışa aktarımları, ödeme dışa aktarımları veya üçüncü taraf uygulama dışa aktarımlarını kullandığınızda Shop Cash'i ödeme verisi olarak değerlendirin. Kullandığınız dışa aktarım veya API kaynağına bağlı olarak Shop Cash bilgileri; ödeme yöntemi, ağ geçidi, sipariş işlemi, ödeme işlemi ve para iadesi verileri aracılığıyla temsil edilebilir.

Bir entegrasyon oluşturduğunuzda veya güncellediğinizde, Shop Cash içeren siparişler için aşağıdaki bilgileri depolayın:

• Sipariş numarası ve sipariş adı.
• Mümkün olan yerlerde shop_cash gibi ödeme yöntemi veya ağ geçidi değeri.
• Her ödeme işlemi için sipariş işlem kimlikleri.
• Yetkilendirme, tahsilat, para iadesi veya geçersiz kılma gibi işlem türü ve durumu.
• İşlem tutarı ve para birimi.
• Mümkün olduğunda üst işlem ilişkileri.
• Mümkün olan yerlerde ödeme kimlikleri.
• Sisteminiz içe aktarıyorsa tam yetkilendirme değerleri.
• Ödemelerin mutabakatını sağlarken ödeme kimlikleri ve bakiye işlem kimlikleri.
• İadelerin mutabakatını sağlarken para iadesi işlem kimlikleri.

Kullanılabilir Admin API alanları hakkında ayrıntılı bilgi için Admin API sipariş işlemi geliştirici belgelerine bakın. Yeni entegrasyonlar için OrderTransaction.authorizationCode gibi kullanımdan kaldırılan alanlara güvenmekten kaçının.

Aşağıdaki basitleştirilmiş örnekte, Shopify Payments aracılığıyla 75,00 USD ve Shop Cash aracılığıyla 25,00 USD olarak ödenen 100,00 USD tutarında bir sipariş gösterilmektedir. Değerler yalnızca açıklama amaçlıdır.

{
  "transactions": [
    {
      "kind": "authorization",
      "gateway": "shopify_payments",
      "status": "success",
      "amount": "75.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "ch_3OabcXYZ..."
    },
    {
      "kind": "authorization",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": null,
      "authorization": "<long-opaque-variable-length-string>"
    },
    {
      "kind": "capture",
      "gateway": "shop_cash",
      "status": "success",
      "amount": "25.00",
      "currency": "USD",
      "parent_id": "<shop-cash-authorization-transaction-id>",
      "authorization": null
    }
  ]
}

Shop Cash diğer ödeme veya promosyon değerlerine benzeyebilir ancak sistemleriniz her değeri ayrı ayrı ele almalıdır:

Shop Cash içeren siparişler için üçüncü taraf bir sisteme güvenmeden önce aşağıdaki gereklilikleri onaylayın:

• Shop Cash, ödeme yöntemi olarak eşlenmiş.
• Shop Cash ve Shop Pay içeren siparişler, her iki ödeme yöntemiyle birlikte içe aktarılır.
• Ödeme yöntemi mantığı, sipariş başına bir ödeme yöntemi olduğunu varsaymaz.
• Yetkilendirme değerleri uzun, opak dizeler olarak depolanır ve kesilmez.
• Para iadesi mantığı, doğru tahsilat işlemi için para iadesi yapabilir.
• Para iadesi mantığı, fonları doğru ödeme yöntemlerine iade edebilir.
• Ödeme mutabakatı; Shop Cash kredisi, para iadesi ve kampanya işlemi türlerini hesaba katabilir.
• Gönderim, muhasebe ve iade iş akışları, Shop Cash'i bir indirim olarak değerlendirmez.

Birden fazla sistem kullanıyorsanız sipariş, işlem, ödeme, gönderim, para iadesi veya iade verilerini alan her bir sistem için bu incelemeyi tamamlayın.