Podaci o narudžbama za Shop Cash i integracije treće strane

Kada korisnik iskoristi Shop Cash pri narudžbi, Shop Cash se tretira kao način plaćanja. To nije popust, poklon kartica ni bon za trgovinu. Preostali saldo narudžbe plaća se putem usluge Shop Pay ili plaćanja u ratama uz Shop Pay.

Na primjer, ako korisnik iskoristi 25 USD usluge Shop Cash na narudžbu od 100 USD, tada narudžba uključuje plaćanje od 25 USD putem usluge Shop Cash i plaćanje od 75 USD putem usluge Shop Pay. Podaci o narudžbi mogu uključivati više od jednog načina plaćanja za istu narudžbu.

Shop Cash prikazuje se kao transakcija narudžbe s vrijednošću pristupnika shop_cash tamo gdje su dostupne vrijednosti pristupnika. Transakcija usluge Shop Cash slijedi standardni životni ciklus transakcije, kao što je autorizacija, terećenje, poništenje i povrat novca. Shop Cash ne upotrebljava vrstu transakcije kombinirane prodaje.

Ako korisnik također upotrijebi Shop ponudu iz usluge Shop Campaigns, vrijednost koju financira kampanja bit će uključena u isti iznos transakcije narudžbe shop_cash. Dijelovi salda kupca i oni financirani putem kampanje ne prikazuju se kao zasebne transakcije narudžbe. Od siječnja 2026. troškovi kampanje naplaćuju se na vašem Shopify računu umjesto da se odbijaju od isplata, pa se transakcije naplate kampanje u aktivnostima isplata odnose samo na kampanje održane prije tog datuma. Više informacija potražite u odjeljku Naknade, Shop Campaigns i Shop Cash.

Sustavi treće strane koji uvoze narudžbe, transakcije, plaćanja, ispunjenja, povrate novca ili povrate moraju prepoznati Shop Cash kao način plaćanja. Ako sustav ne prepoznaje Shop Cash, uvoz narudžbi koje ga uključuju može biti neuspješan, narudžbe se mogu uvesti s nepotpunim podacima o plaćanju ili može biti potrebno ručno mapiranje.

Sa svojim pružateljem sustava treće strane pregledajte sljedeće zahtjeve:

• Sustav može podržavati više od jednog načina plaćanja po narudžbi.
• Sustav može mapirati shop_cash kao način plaćanja.
• Sustav ne tretira Shop Cash kao popust, poklon karticu ni bon za trgovinu.
• Sustav pohranjuje ID transakcije narudžbe za svaku autorizaciju, terećenje, poništenje i povrat novca unutar usluge Shop Cash.
• Sustav pohranjuje cjelokupnu vrijednost autorizacije za Shop Cash bez skraćivanja, ako je vrijednost uključena u podatke koje sustav uvozi.
• Sustav tretira vrijednosti autorizacije kao neprozirne nizove, ne raščlanjuje ih, ne dekodira, ne normalizira, ne pretvara ih u zbirna raspršivanja i iz njih ne izvodi značenje.
• Sustav može obraditi povrate novca kojima se sredstva vraćaju uslugama Shop Pay i Shop Cash.
• Sustav može uskladiti isplatne transakcije za Shop Cash odvojeno od transakcija kartičnog plaćanja.
• Sustav ne pretpostavlja da se transakcije vraćaju određenim redoslijedom.

Ako vaš sustav treće strane pretpostavlja da svaka narudžba ima samo jedan način plaćanja, obratite se pružatelju prije obrade narudžbi plaćenih uslugom Shop Cash kroz taj sustav.

Vrijednost autorizacije na transakciji za Shop Cash neproziran je niz promjenjive duljine. To nije kratak autorizacijski kod kartice i nije čitljiv ljudima.

Ako vaš ERP, OMS ili neki drugi sustav treće strane uvozi vrijednosti autorizacije za Shop Cash, pohranite punu vrijednost točno onako kako je navedena. Gdje je moguće, upotrijebite tekstualno polje promjenjive ili neograničene duljine.

Kada vaš sustav pohranjuje vrijednosti autorizacije za Shop Cash, pridržavajte se sljedećih smjernica:

• Nemojte skraćivati vrijednost na kratku fiksnu duljinu, poput 50 ili 100 znakova.
• Nemojte raščlanjivati niti izvoditi značenje ni iz jednog dijela vrijednosti.
• Nemojte upotrebljavati vrijednost autorizacije za identifikaciju transakcija za API operacije terećenja, poništenja ili povrata novca.

Skraćene vrijednosti autorizacije mogu uzrokovati neuspješne uvoze treće strane ili daljnje obrade u ERP-u i OMS-u.

Da biste podržali terećenja, poništenja i povrate novca putem Admin API-ja, pohranite ID-ove transakcija narudžbi i odnose nadređenih transakcija. Operacije terećenja i poništenja putem Admin API-ja identificiraju autorizacijsku transakciju sa stavkom parentTransactionId. Operacije povrata novca identificiraju transakciju terećenja za koju je moguć povrat novca stavkom parentId.

Kada aplikacija ili integracija izda povrat novca za Shop Cash putem API-ja, povrat novca mora biti podređen transakciji terećenja za Shop Cash, a ne transakciji autorizacije za Shop Cash. Odbijaju se povrati novca na temelju transakcije autorizacije.

Aplikacije za povrat novca i alati za rukovanje za webhook trebaju identificirati transakciju terećenja za Shop Cash s mogućim povratom novca, izračunati preostali iznos s mogućim povratom za to terećenje i izraditi povrat novca prema ID-u transakcije terećenja.

Kada upotrebljavate Admin API, izvoze narudžbi, izvoze isplata ili izvoze aplikacija treće strane, tretirajte Shop Cash kao podatke o plaćanju. Ovisno o izvozu ili API resursu koji upotrebljavate, informacije za Shop Cash mogu biti prikazane u podacima o načinu plaćanja, pristupniku, transakciji narudžbe, transakciji isplate i povratu novca.

Prilikom izgradnje ili ažuriranja integracije, pohranite sljedeće informacije za narudžbe koje uključuju Shop Cash:

• ID narudžbe i naziv narudžbe.
• Način plaćanja ili vrijednost pristupnika, kao što je shop_cash ako je dostupno.
• ID-ovi transakcija narudžbe za svaku transakciju plaćanja.
• Vrsta i status transakcije, kao što su autorizacija, naplata, povrat novca ili poništenje.
• Iznos i valuta transakcije.
• Odnosi nadređenih transakcija, ako su dostupni.
• ID-ovi plaćanja, ako su dostupni.
• Pune vrijednosti autorizacije, ako ih vaš sustav uvozi.
• ID-ovi isplata i ID-ovi transakcija salda pri usklađivanju isplata.
• ID-ovi transakcija povrata novca pri usklađivanju povrata.

Za pojedinosti o dostupnim poljima za Admin API pogledajte dokumentaciju za razvojne programere na temu transakcija narudžbe za Admin API. Za nove integracije izbjegavajte oslanjanje na zastarjela polja kao što je OrderTransaction.authorizationCode.

Sljedeći pojednostavljeni primjer prikazuje narudžbu u iznosu od 100 USD plaćenu sa 75 USD putem usluge Shopify Payments i 25 USD putem usluge Shop Cash. Vrijednosti su isključivo ilustrativne.

{
  "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 može izgledati slično drugim vrijednostima plaćanja ili promotivnim vrijednostima, ali vaši bi sustavi trebali tretirati svaku vrijednost zasebno:

Prije nego što se oslonite na sustav treće strane za narudžbe koje uključuju Shop Cash, provjerite sljedeće preduvjete:

• Shop Cash je mapiran kao način plaćanja.
• Narudžbe sa sredstvima Shop Cash i uslugom Shop Pay uvoze se s obama načinima plaćanja.
• Logika načina plaćanja ne pretpostavlja samo jedan način plaćanja po narudžbi.
• Vrijednosti autorizacije pohranjuju se kao dugi neprozirni nizovi i ne skraćuju se.
• Logika za povrat novca može izvršiti povrat za ispravnu transakciju naplate.
• Logika za povrat novca može vratiti sredstva na ispravne načine plaćanja.
• Usklađivanje isplata može obuhvatiti vrste transakcija za Shop Cash koje uključuju kredite, povrat novca i kampanje.
• Tijekovi rada za ispunjenje, računovodstvo i povrat ne tretiraju Shop Cash kao popust.

Ako upotrebljavate više sustava, provedite ovaj pregled za svaki sustav koji prima podatke o narudžbama, transakcijama, isplatama, ispunjenju, povratu novca ili povratima.