„Shop Cash“ užsakymų duomenys ir trečiųjų šalių integracijos

Kai klientas užsakymui apmokėti naudoja „Shop Cash“, tai traktuojama kaip mokėjimo būdas. Tai nėra nuolaida, dovanų kortelė ar parduotuvės kreditas. Bet koks likęs užsakymo likutis sumokamas naudojant „Shop Pay“ arba „Shop Pay Installments“.

Pavyzdžiui, jei klientas 100 USD vertės užsakymui panaudoja 25 USD iš „Shop Cash“, į užsakymą įtraukiamas 25 USD „Shop Cash“ mokėjimas ir 75 USD „Shop Pay“ mokėjimas. Jūsų užsakymo duomenyse tam pačiam užsakymui gali būti nurodytas daugiau nei vienas mokėjimo būdas.

„Shop Cash“ rodoma kaip užsakymo operacija su šliuzo reikšme shop_cash, kur šliuzo reikšmės yra prieinamos. „Shop Cash“ operacija atitinka standartinį operacijos ciklą, pvz., autorizaciją, lėšų fiksavimą, anuliavimą ir pinigų grąžinimą. „Shop Cash“ nenaudoja kombinuoto pardavimo operacijos tipo.

Jei klientas taip pat naudojasi „Shop“ pasiūlymu iš „Shop Campaigns“, kampanijos finansuojama vertė įtraukiama į tą pačią shop_cash užsakymo operacijos sumą. Pirkėjo likučio ir kampanijos finansuojamos dalys nėra pateikiamos kaip atskiros užsakymo operacijos. Nuo 2026 m. sausio mėn. kampanijos išlaidos įtraukiamos į Jūsų „Shopify“ sąskaitą, o ne atskaitomos iš išmokėjimų, todėl kampanijų sąskaitų operacijos išmokėjimų duomenyse taikomos tik kampanijoms, vykdytoms iki šios datos. Išsamesnės informacijos rasite skyriuje Mokesčiai, „Shop Campaigns“ ir „Shop Cash“.

Trečiųjų šalių sistemos, kurios importuoja užsakymus, operacijas, mokėjimus, užsakymų įvykdymus, pinigų grąžinimus ar grąžinimus, turi atpažinti „Shop Cash“ kaip mokėjimo būdą. Jei sistema neatpažįsta „Shop Cash“, užsakymai su „Shop Cash“ gali būti neimportuoti, importuoti su nepilnais mokėjimo duomenimis arba gali prireikti rankinio susiejimo.

Peržiūrėkite šiuos reikalavimus su savo trečiosios šalies sistemos teikėju:

• Sistema gali palaikyti daugiau nei vieną mokėjimo būdą vienam užsakymui.
• Sistema gali susieti shop_cash kaip mokėjimo būdą.
• Sistema netraktuoja „Shop Cash“ kaip nuolaidos, dovanų kortelės ar parduotuvės kredito.
• Sistema išsaugo užsakymo operacijos ID kiekvienai „Shop Cash“ autorizacijai, lėšų fiksavimui, anuliavimui ir pinigų grąžinimui.
• Sistema išsaugo visą „Shop Cash“ autorizacijos reikšmę jos nesutrumpindama, jei ši reikšmė įtraukta į sistemos importuojamus duomenis.
• Sistema autorizacijos reikšmes traktuoja kaip neskaidrias eilutes ir jų neanalizuoja, nedekoduoja, nenormalizuoja, nešifruoja maiša ir neinterpretuoja jų prasmės.
• Sistema gali apdoroti pinigų grąžinimus, kuriais lėšos grąžinamos ir į „Shop Pay“, ir į „Shop Cash“.
• Sistema gali sutikrinti „Shop Cash“ išmokėjimo operacijas atskirai nuo kortelių mokėjimo operacijų.
• Sistema nedaro prielaidos, kad operacijos grąžinamos tam tikra tvarka.

Jei Jūsų trečiosios šalies sistema daro prielaidą, kad kiekvienas užsakymas turi tik vieną mokėjimo būdą, prieš apdorodami „Shop Cash“ užsakymus šioje sistemoje, susisiekite su teikėju.

„Shop Cash“ operacijos autorizacijos reikšmė yra neskaidri, kintamo ilgio eilutė. Tai nėra trumpas kortelės autorizacijos kodas ir ji nėra skaitoma žmogaus.

Jei Jūsų ERP, OMS ar kita trečiosios šalies sistema importuoja „Shop Cash“ autorizacijos reikšmes, išsaugokite visą reikšmę tiksliai taip, kaip ji pateikta. Kur įmanoma, naudokite kintamo ilgio arba neriboto ilgio teksto lauką.

Kai Jūsų sistema išsaugo „Shop Cash“ autorizacijos reikšmes, laikykitės šių gairių:

• Netrumpinkite reikšmės iki trumpo fiksuoto ilgio, pavyzdžiui, 50 ar 100 simbolių.
• Neanalizuokite ir neinterpretuokite jokios reikšmės dalies prasmės.
• Nenaudokite autorizacijos reikšmės lėšų fiksavimo, anuliavimo ar pinigų grąžinimo API operacijoms identifikuoti.

Dėl sutrumpintų autorizacijos reikšmių gali nepavykti atlikti trečiųjų šalių importo arba vėlesnių ERP ir OMS apdorojimo procesų.

Kad palaikytumėte lėšų fiksavimą, anuliavimą ir pinigų grąžinimą per „Admin API“, išsaugokite užsakymo operacijų ID ir pirminių operacijų ryšius. „Admin API“ lėšų fiksavimo ir anuliavimo operacijos identifikuoja autorizacijos operaciją naudodamos parentTransactionId. Pinigų grąžinimo operacijos identifikuoja grąžinamą lėšų fiksavimo operaciją naudodamos parentId.

Kai programėlė ar integracija per API inicijuoja „Shop Cash“ pinigų grąžinimą, grąžinimas turi būti susietas su pirmine „Shop Cash“ lėšų fiksavimo operacija, o ne su „Shop Cash“ autorizacijos operacija. Pinigų grąžinimai, susieti su autorizacijos operacija, yra atmetami.

Pinigų grąžinimo programėlės ir žiniatinklio kabliukų apdorojimo programos turėtų identifikuoti grąžinamą „Shop Cash“ lėšų fiksavimo operaciją, apskaičiuoti likusią grąžinamą to fiksavimo sumą ir sukurti pinigų grąžinimą pagal lėšų fiksavimo operacijos ID.

Kai naudojate Admin API, užsakymų, išmokėjimų arba trečiosios šalies programėlių eksporto funkcijas, traktuokite „Shop Cash“ kaip mokėjimo duomenis. Priklausomai nuo eksporto ar API ištekliaus, kurį naudojate, „Shop Cash“ informacija gali būti pateikta per mokėjimo būdą, šliuzą, užsakymo operaciją, išmokėjimo operaciją ir pinigų grąžinimo duomenis.

Kai kuriate ar atnaujinate integraciją, išsaugokite šią informaciją apie užsakymus, kuriuose naudojamas „Shop Cash“:

• Užsakymo ID ir užsakymo pavadinimas.
• Mokėjimo būdo arba šliuzo reikšmė, pvz., shop_cash, kur įmanoma.
• Kiekvienos mokėjimo operacijos užsakymo operacijos ID.
• Operacijos tipas ir būsena, pvz., autorizavimas, lėšų nuskaitymas, pinigų grąžinimas arba anuliavimas.
• Operacijos suma ir valiuta.
• Pirminės operacijos ryšiai, kai jie prieinami.
• Mokėjimo ID, kur įmanoma.
• Visos autorizavimo reikšmės, jei Jūsų sistema jas importuoja.
• Išmokėjimų ID ir likučio operacijų ID, kai atliekate išmokėjimų sutikrinimą.
• Pinigų grąžinimo operacijų ID, kai atliekate grąžinimų sutikrinimą.

Išsamią informaciją apie prieinamus Admin API laukus rasite Admin API order transaction programuotojų dokumentacijoje. Naujoms integracijoms venkite naudoti nebepalaikomus laukus, pvz., OrderTransaction.authorizationCode.

Toliau pateiktame supaprastintame pavyzdyje parodytas 100 USD vertės užsakymas, už kurį sumokėta 75 USD per „Shopify Payments“ ir 25 USD per „Shop Cash“. Reikšmės yra tik iliustracinio pobūdžio.

{
  "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“ gali atrodyti panašiai kaip kitos mokėjimo ar reklaminės vertės, tačiau Jūsų sistemos kiekvieną vertę turėtų apdoroti atskirai:

Prieš pradedant naudoti trečiosios šalies sistemą užsakymams su „Shop Cash“, patvirtinkite šiuos reikalavimus:

• „Shop Cash“ yra susietas kaip mokėjimo būdas.
• Užsakymai su „Shop Cash“ ir „Shop Pay“ importuojami naudojant abu mokėjimo būdus.
• Mokėjimo būdo logika neapsiriboja vienu mokėjimo būdu vienam užsakymui.
• Autorizavimo reikšmės saugomos kaip ilgos, nepermatomos eilutės ir nėra sutrumpinamos.
• Pinigų grąžinimo logika gali grąžinti pinigus už teisingą lėšų nuskaitymo operaciją.
• Pinigų grąžinimo logika gali grąžinti lėšas į teisingus mokėjimo būdus.
• Išmokėjimų sutikrinimas gali apdoroti „Shop Cash“ kredito, pinigų grąžinimo ir kampanijos operacijų tipus.
• Užsakymo įvykdymo, apskaitos ir grąžinimo darbo eigos netraktuoja „Shop Cash“ kaip nuolaidos.

Jei naudojate kelias sistemas, atlikite šią peržiūrą kiekvienai sistemai, gaunančiai užsakymo, operacijos, išmokėjimo, užsakymo įvykdymo, pinigų grąžinimo ar prekių grąžinimo duomenis.