Podatki o naročilih prek storitve Shop Cash in integracije drugih ponudnikov

Ko stranka pri naročilu uporabi Shop Cash, se Shop Cash obravnava kot način plačila. To ni popust, darilna kartica ali dobroimetje za nakup. Preostalo stanje naročila se plača prek storitve Shop Pay ali storitve Shop Pay plačilo na obroke.

Če na primer stranka pri naročilu v vrednosti 100 USD porabi 25 USD iz storitve Shop Cash, naročilo vključuje plačilo prek storitve Shop Cash v vrednosti 25 USD in plačilo prek storitve Shop Pay v vrednosti 75 USD. Vaši podatki o naročilu lahko vključujejo več kot en način plačila za isto naročilo.

Shop Cash je prikazan kot transakcija naročila z vrednostjo prehoda shop_cash tam, kjer so na voljo vrednosti prehoda. Transakcija Shop Cash sledi standardnemu življenjskemu ciklu transakcije, na primer avtorizaciji, zajemu, razveljavitvi in povračilu. Shop Cash ne uporablja kombinirane vrste prodajne transakcije.

Če stranka uporablja tudi ponudbo Shop iz storitve Shop Campaigns, je vrednost, ki jo financira oglaševalska akcija, vključena v isti znesek transakcije naročila shop_cash. Stanje kupca in deli, ki jih financira oglaševalska akcija, niso prikazani kot ločene transakcije naročila. Od januarja 2026 dalje se stroški oglaševalskih akcij bremenijo na vašem računu Shopify in se ne odštejejo od vaših izplačil, zato transakcije obračunavanja oglaševalskih akcij v dejavnosti izplačil veljajo le za oglaševalske akcije, ki so potekale pred tem datumom. Za več informacij glejte Provizije, Shop Campaigns in Shop Cash.

Sistemi drugih ponudnikov, ki uvažajo naročila, transakcije, plačila, izpolnitve, povračila ali vračila, morajo prepoznati Shop Cash kot način plačila. Če sistem storitve Shop Cash ne prepozna, se lahko uvoz naročil, ki vključujejo Shop Cash, ne izvede uspešno, uvozijo se nepopolni podatki o plačilu ali pa je potrebno ročno preslikavanje.

Preverite naslednje zahteve pri ponudniku sistema drugega ponudnika:

• Sistem lahko podpira več kot en način plačila za eno naročilo.
• Sistem lahko preslika shop_cash kot način plačila.
• Sistem storitve Shop Cash ne obravnava kot popust, darilno kartico ali dobroimetje za nakup.
• Sistem shrani ID transakcije naročila za vsako avtorizacijo, zajem, razveljavitev in povračilo pri storitvi Shop Cash.
• Sistem shrani celotno avtorizacijsko vrednost za Shop Cash, ne da bi jo skrajšal, če je vrednost vključena v podatke, ki jih sistem uvaža.
• Sistem obravnava avtorizacijske vrednosti kot neprozorne nize in jih ne razčlenjuje, dekodira, normalizira, zgoščuje ali iz njih sklepa pomena.
• Sistem lahko obdela povračila, ki vrnejo sredstva v storitvi Shop Pay in Shop Cash.
• Sistem lahko uskladi transakcije izplačil storitve Shop Cash ločeno od transakcij plačil s kartico.
• Sistem ne predvideva, da so transakcije vrnjene v določenem vrstnem redu.

Če vaš sistem drugega ponudnika predvideva, da ima posamezno naročilo le en način plačila, se pred obdelavo naročil s storitvijo Shop Cash prek tega sistema obrnite na ponudnika.

Avtorizacijska vrednost na transakciji storitve Shop Cash je neprozoren niz spremenljive dolžine. To ni kratka avtorizacijska koda kartice in ni berljiva za ljudi.

Če vaš sistem ERP, OMS ali drug sistem drugega ponudnika uvaža avtorizacijske vrednosti storitve Shop Cash, shranite celotno vrednost točno tako, kot je bila posredovana. Kjer je mogoče, uporabite besedilno polje s spremenljivo dolžino ali neomejeno besedilno polje.

Ko vaš sistem shrani avtorizacijske vrednosti storitve Shop Cash, upoštevajte te smernice:

• Ne skrajšajte vrednosti na kratko fiksno dolžino, na primer na 50 ali 100 znakov.
• Ne razčlenjujte ali sklepajte pomena iz katerega koli dela vrednosti.
• Ne uporabljajte avtorizacijske vrednosti za identifikacijo transakcij za operacije API za zajem, razveljavitev ali povračilo.

Skrajšane avtorizacijske vrednosti lahko povzročijo, da so uvozi drugih ponudnikov ali nadaljnja obdelava v sistemih ERP in OMS neuspešni.

Za podporo zajemom, razveljavitvam in povračilom prek storitve Admin API shranite ID-je transakcij naročil in odnose nadrejenih transakcij. Operacije zajema in razveljavitve v storitvi Admin API identificirajo avtorizacijsko transakcijo s parametrom parentTransactionId. Operacije povračila identificirajo povračljivo transakcijo zajema s parametrom parentId.

Ko aplikacija ali integracija izda povračilo v storitvi Shop Cash prek vmesnika API, mora biti povračilo podrejeno transakciji zajema storitve Shop Cash in ne avtorizacijski transakciji. Povračila za avtorizacijsko transakcijo so zavrnjena.

Aplikacije za povračila in upravljalniki spletnih kavljev naj identificirajo povračljivo transakcijo zajema za Shop Cash, izračunajo preostali znesek za povračilo za ta zajem in ustvarijo povračilo za ID transakcije zajema.

Pri uporabi rešitve Admin API, izvozu naročil, izvozu izplačil ali izvozu prek aplikacij drugih ponudnikov obravnavajte Shop Cash kot podatke o plačilu. Odvisno od uporabljenega izvoza ali vira API so lahko informacije o storitvi Shop Cash prikazane prek podatkov o načinu plačila, prehodu, transakciji naročila, transakciji izplačila in povračilu.

Pri ustvarjanju ali posodabljanju integracije shranite naslednje informacije za naročila, ki vključujejo Shop Cash:

• ID naročila in ime naročila.
• Način plačila ali vrednost prehoda, kot je shop_cash, kjer je na voljo.
• ID-ji transakcij naročil za vsako plačilno transakcijo.
• Vrsta in stanje transakcije, kot je avtorizacija, zajem, povračilo ali razveljavitev.
• Znesek in valuta transakcije.
• Povezave z nadrejeno transakcijo, kjer so na voljo.
• ID-ji plačil, kjer so na voljo.
• Celotne vrednosti avtorizacije, če jih vaš sistem uvaža.
• ID-ji izplačil in ID-ji transakcij stanja pri usklajevanju izplačil.
• ID-ji transakcij povračil pri usklajevanju vračil.

Za podrobnosti o razpoložljivih poljih v Admin API si oglejte dokumentacijo za razvijalce o transakcijah naročil v Admin API. Pri novih integracijah se izogibajte zanašanju na opuščena polja, kot je OrderTransaction.authorizationCode.

Spodnji poenostavljeni primer prikazuje naročilo v vrednosti 100 USD, od katerega je bilo 75 USD plačanih prek storitve Shopify Payments, 25 USD pa prek storitve Shop Cash. Vrednosti so le informativne narave.

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

Storitev Shop Cash je lahko videti podobno drugim plačilnim ali promocijskim vrednostim, vendar morajo vaši sistemi vsako vrednost obravnavati ločeno:

Preden se zanesete na sistem drugega ponudnika za naročila, ki vključujejo Shop Cash, potrdite naslednje zahteve:

• Storitev Shop Cash je preslikana kot način plačila.
• Naročila s storitvama Shop Cash in Shop Pay so uvožena z obema načinoma plačila.
• Logika načina plačila ne predvideva samo enega načina plačila na naročilo.
• Vrednosti avtorizacije so shranjene kot dolgi neprosojni nizi in niso skrajšane.
• Logika povračila lahko povrne ustrezen znesek transakcije zajema.
• Logika povračila lahko vrne sredstva na ustrezne načine plačila.
• Usklajevanje izplačil lahko upošteva vrste transakcij, kot so dobroimetje, povračilo in oglaševalske akcije za Shop Cash.
• Poteki dela za izpolnitve, računovodstvo in vračila storitve Shop Cash ne obravnavajo kot popust.

Če uporabljate več sistemov, opravite ta pregled za vsak sistem, ki prejema podatke o naročilih, transakcijah, izplačilih, izpolnitvah, povračilih ali vračilih.