Shop Cash-rendelésadatok és harmadik féltől származó integrációk

Ha egy vásárló Shop Cash-t használ egy rendelésnél, a Shop Cash fizetési módnak minősül. Nem minősül kedvezménynek, ajándékkártyának vagy üzleti jóváírásnak. A fennmaradó rendelési egyenleg kifizetése Shop Pay vagy Shop Pay részletre vásárlás használatával történik.

Például, ha egy vásárló 25 USD értékű Shop Cash-t használ fel egy 100 USD-s rendelésnél, akkor a rendelés egy 25 USD-s Shop Cash-fizetést és egy 75 USD-s Shop Pay-fizetést tartalmaz. A rendelésadatai több fizetési módot is tartalmazhatnak ugyanahhoz a rendeléshez.

A Shop Cash olyan rendelési tranzakcióként jelenik meg shop_cash átjáróértékkel, ahol az átjáróértékek elérhetők. A Shop Cash-tranzakció követi a szabványos tranzakció-életciklust, például az engedélyezést, a rögzítést, az érvénytelenítést és a visszatérítést. A Shop Cash nem használ kombinált értékesítési tranzakciótípust.

Ha a vásárló egy Shop Campaignből származó Shop-ajánlatot is felhasznál, akkor a kampányból finanszírozott érték ugyanabban a shop_cash rendelési tranzakcióösszegben szerepel. A vásárló egyenlegéből és a kampányból finanszírozott részek nem külön rendelési tranzakciókként jelennek meg. 2026 januárjától a kampányköltségeket a Shopify-nyugtára terhelik a kifizetésekből történő levonás helyett, így a kifizetési tevékenységek kampányszámlázási tranzakciói csak az ezen dátum előtt futott kampányokra vonatkoznak. További információért tekintse meg a Díjak, Shop Campaigns és Shop Cash című részt.

A rendeléseket, tranzakciókat, fizetéseket, teljesítéseket, visszatérítéseket vagy visszaküldéseket importáló, harmadik féltől származó rendszereknek fizetési módként kell felismerniük a Shop Cash-t. Ha egy rendszer nem ismeri fel a Shop Cash-t, akkor a Shop Cash-t tartalmazó rendelések importálása sikertelen lehet, hiányos fizetési adatokkal importálódhatnak, vagy manuális leképezést igényelhetnek.

Tekintse át a következő követelményeket a harmadik féltől származó rendszere szolgáltatójával:

• A rendszer képes egynél több fizetési módot is támogatni egyetlen rendelésnél.
• A rendszer képes leképezni a shop_cash értéket fizetési módként.
• A rendszer nem kezeli a Shop Cash-t kedvezményként, ajándékkártyaként vagy üzleti jóváírásként.
• A rendszer tárolja a rendelésitranzakció-azonosítót minden Shop Cash-engedélyezés, -rögzítés, -érvénytelenítés és -visszatérítés esetén.
• A rendszer a teljes Shop Cash-engedélyezési értéket tárolja annak csonkolása nélkül, ha az érték szerepel a rendszer által importált adatokban.
• A rendszer az engedélyezési értékeket átlátszatlan karakterláncokként kezeli, és nem elemzi, dekódolja, normalizálja, hasheli azokat, illetve nem következtet belőlük jelentésre.
• A rendszer képes feldolgozni azokat a visszatérítéseket, amelyek mind a Shop Pay, mind a Shop Cash részére juttatnak vissza pénzeszközöket.
• A rendszer a kártyás fizetési tranzakcióktól elkülönítve tudja egyeztetni a Shop Cash kifizetési tranzakcióit.
• A rendszer nem feltételezi, hogy a tranzakciók egy adott sorrendben térnek vissza.

Ha a harmadik féltől származó rendszere azt feltételezi, hogy minden rendeléshez csak egy fizetési mód tartozik, vegye fel a kapcsolatot a szolgáltatóval, mielőtt Shop Cash-rendeléseket dolgozna fel ezen a rendszeren keresztül.

A Shop Cash-tranzakció engedélyezési értéke egy átlátszatlan, változó hosszúságú karakterlánc. Ez nem egy rövid kártyaengedélyezési kód, és nem ember által olvasható formátumú.

Ha az ERP-, OMS- vagy más harmadik féltől származó rendszere importálja a Shop Cash-engedélyezési értékeket, a teljes értéket pontosan a megadott formában tárolja. Ahol lehetséges, használjon változó hosszúságú vagy korlátlan szövegmezőt.

Amikor a rendszere Shop Cash-engedélyezési értékeket tárol, kövesse az alábbi irányelveket:

• Ne csonkolja az értéket egy rövid, rögzített hosszúságra, például 50 vagy 100 karakterre.
• Ne elemezze az értéket, és ne vonjon le jelentést annak semelyik részéből.
• Ne használja az engedélyezési értéket a rögzítési, érvénytelenítési vagy visszatérítési API-műveletek tranzakcióinak azonosítására.

A csonkolt engedélyezési értékek a harmadik fél általi importálások vagy a későbbi ERP- és OMS-feldolgozások sikertelenségét okozhatják.

Az Admin API-n keresztüli rögzítések, érvénytelenítések és visszatérítések támogatásához tárolja a rendelésitranzakció-azonosítókat és a szülő tranzakciók kapcsolatait. Az Admin API rögzítési és érvénytelenítési műveletei a parentTransactionId értékkel azonosítják az engedélyezési tranzakciót. A visszatérítési műveletek a parentId értékkel azonosítják a visszatéríthető rögzítési tranzakciót.

Amikor egy alkalmazás vagy integráció egy Shop Cash-visszatérítést indít el az API-n keresztül, a visszatérítést a Shop Cash-rögzítési tranzakcióhoz kell kapcsolni, nem pedig a Shop Cash-engedélyezési tranzakcióhoz. Az engedélyezési tranzakcióval szembeni visszatérítéseket a rendszer elutasítja.

A visszatérítési alkalmazásoknak és webhook-kezelőknek azonosítaniuk kell a visszatéríthető Shop Cash-rögzítési tranzakciót, ki kell számítaniuk az adott rögzítéshez tartozó fennmaradó visszatéríthető összeget, és a visszatérítést a rögzítési tranzakció azonosítója alapján kell létrehozniuk.

Amikor az Admin API-t, a rendelések és a kifizetések exportálását, vagy harmadik féltől származó alkalmazások exportjait használja, a Shop Cash-t fizetési adatként kezelje. A használt exportálástól vagy API-erőforrástól függően a Shop Cash adatai fizetési mód, átjáró, rendelési tranzakció, kifizetési tranzakció és visszatérítési adatok formájában is megjelenhetnek.

Integrációk létrehozásakor vagy frissítésekor tárolja az alábbi információkat a Shop Cash-t is tartalmazó rendelésekről:

• Rendelési azonosító és rendelési név.
• A fizetési mód vagy az átjáró értéke, például shop_cash, ha elérhető.
• Rendelési tranzakcióazonosító minden egyes fizetési tranzakcióhoz.
• Tranzakció típusa és állapota, például engedélyezés, rögzítés, visszatérítés vagy érvénytelenítés.
• Tranzakció összege és valutája.
• Szülőtranzakciós kapcsolatok, ha elérhetők.
• Fizetési azonosítók, ahol elérhetők.
• Teljes engedélyezési értékek, ha a rendszere importálja őket.
• Kifizetési azonosítók és egyenlegtranzakció-azonosítók a kifizetések egyeztetésekor.
• Visszatérítési tranzakcióazonosítók a visszavételek egyeztetésekor.

Az elérhető Admin API-mezőkkel kapcsolatos részletekért tekintse meg az Admin API rendelési tranzakcióival kapcsolatos fejlesztői dokumentációt. Új integrációk esetén kerülje az elavult mezők, például az OrderTransaction.authorizationCode használatát.

A következő egyszerűsített példa egy 100 USA-dolláros rendelést mutat, amelyből 75 USA-dollárt a Shopify Payments, 25 USA-dollárt pedig Shop Cash használatával fizettek ki. Az értékek csupán illusztrációk.

{
  "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
    }
  ]
}

A Shop Cash hasonló lehet más fizetési vagy promóciós értékekhez, de a rendszereinek minden értéket külön kell kezelniük:

Mielőtt egy harmadik féltől származó rendszerre támaszkodna a Shop Cash-t is tartalmazó rendelések esetén, ellenőrizze az alábbi követelményeket:

• A Shop Cash fizetési módként van leképezve.
• A Shop Cash-t és Shop Payt is tartalmazó rendelések mindkét fizetési móddal importálva vannak.
• A fizetési mód logikája nem feltételez rendelésenként csak egy fizetési módot.
• Az engedélyezési értékek hosszú, átlátszatlan karakterláncokként vannak tárolva, és nincsenek csonkolva.
• A visszatérítési logika a megfelelő rögzítési tranzakciót tudja visszatéríteni.
• A visszatérítési logika a megfelelő fizetési módokra tudja visszajuttatni az összeget.
• A kifizetések egyeztetése képes elszámolni a Shop Cash jóváírási, visszatérítési és kampánytranzakciós típusait.
• A teljesítési, könyvelési és visszavételi munkafolyamatok nem kezelik kedvezményként a Shop Cash-t.

Ha több rendszert használ, végezze el ezt az ellenőrzést minden olyan rendszernél, amely rendelési, tranzakciós, kifizetési, teljesítési, visszatérítési vagy visszavételi adatokat fogad.