Podaci o Shop Cash porudžbinama i integracije trećih strana
Shop Cash se u porudžbinama beleži kao način plaćanja. Možete da koristite podatke o Shop Cash porudžbinama da biste pripremili sisteme trećih strana, pregledali porudžbine koje uključuju više od jednog načina plaćanja i sravnili Shop Cash aktivnosti sa isplatama i povraćajima sredstava.
Ako vaša prodavnica koristi sistem za planiranje resursa preduzeća (ERP), sistem za upravljanje porudžbinama (OMS), sistem za realizaciju, aplikaciju za povraćaje, računovodstveni sistem ili drugu aplikaciju treće strane, potvrdite da sistem može da uvozi i obrađuje podatke o Shop Cash porudžbinama pre nego što se oslonite na njega za tokove posla u vezi sa realizacijom, računovodstvom ili sravnjivanjem.
Na ovoj stranici
- Kako se Shop Cash beleži u porudžbinama
- Zahtevi sistema trećih strana za Shop Cash
- Vrednosti autorizacije
- Zahtevi za transakcije povraćaja sredstava
- Napomene o API-ju i izvozu
- Primer strukture transakcije porudžbine
- Po čemu se Shop Cash razlikuje od sličnih vrednosti porudžbine
- Kontrolna lista za Shop Cash integraciju
Kako se Shop Cash beleži u porudžbinama
Kada kupac koristi Shop Cash za porudžbinu, Shop Cash se tretira kao način plaćanja. To nije popust, poklon kartica ili kredit prodavnice. Preostali iznos porudžbine se plaća pomoću opcije Shop Pay ili Shop Pay na rate.
Na primer, ako kupac iskoristi 25 USD u opciji Shop Cash na porudžbinu od 100 USD, tada porudžbina uključuje Shop Cash plaćanje od 25 USD i Shop Pay plaćanje od 75 USD. Podaci o porudžbini mogu da uključuju više od jednog načina plaćanja za istu porudžbinu.
Shop Cash se prikazuje kao transakcija porudžbine sa gateway vrednošću shop_cash tamo gde su gateway vrednosti dostupne. Shop Cash transakcija prati standardni životni ciklus transakcije, kao što su autorizacija, naplata, poništavanje i povraćaj sredstava. Shop Cash ne koristi kombinovanu vrstu prodajne transakcije.
Ako kupac takođe iskoristi Shop ponudu iz Shop Campaigns kampanje, tada je vrednost koju finansira kampanja uključena u isti iznos shop_cash transakcije porudžbine. Deo iz stanja kupca i deo koji finansira kampanja se ne prikazuju kao zasebne transakcije porudžbine. Od januara 2026, troškovi kampanje se naplaćuju na vašem Shopify računu umesto da se odbijaju od vaših isplata, tako da se transakcije naplate kampanje u aktivnostima isplate odnose samo na kampanje koje su pokrenute pre tog datuma. Za više informacija, pogledajte Naknade, Shop Campaigns i Shop Cash.
Zahtevi sistema trećih strana za Shop Cash
Sistemi trećih strana koji uvoze porudžbine, transakcije, plaćanja, realizacije, povraćaje sredstava ili povraćaje, moraju da prepoznaju Shop Cash kao način plaćanja. Ako sistem ne prepoznaje Shop Cash, porudžbine koje uključuju Shop Cash se možda neće uvesti, mogu se uvesti sa nepotpunim podacima o plaćanju ili će zahtevati ručno mapiranje.
Pregledajte sledeće zahteve sa svojim pružaocem sistema treće strane:
- Sistem može da podrži više od jednog načina plaćanja za jednu porudžbinu.
- Sistem može da mapira
shop_cashkao način plaćanja. - Sistem ne tretira Shop Cash kao popust, poklon karticu ili kredit prodavnice.
- Sistem čuva ID transakcije porudžbine za svaku Shop Cash autorizaciju, naplatu, poništavanje i povraćaj sredstava.
- Sistem čuva punu Shop Cash vrednost autorizacije bez skraćivanja, ako je vrednost uključena u podatke koje sistem uvozi.
- Sistem tretira vrednosti autorizacije kao neprozirne stringove i ne parsira ih, ne dekodira, ne normalizuje, ne hešira i ne izvodi značenje iz njih.
- Sistem može da obradi povraćaje sredstava koji vraćaju sredstva i na Shop Pay i na Shop Cash.
- Sistem može da sravni Shop Cash transakcije isplata odvojeno od transakcija plaćanja karticom.
- Sistem ne pretpostavlja da se transakcije vraćaju po određenom redosledu.
Ako vaš sistem treće strane podrazumeva da svaka porudžbina ima samo jedan način plaćanja, kontaktirajte sa pružaocem usluga pre obrade Shop Cash porudžbina kroz taj sistem.
Vrednosti autorizacije
Vrednost autorizacije kod Shop Cash transakcije je neproziran string promenljive dužine. To nije kratki autorizacioni kôd kartice i nije čitljiv za ljude.
Ako vaš ERP, OMS ili drugi sistem treće strane uvozi Shop Cash vrednosti autorizacije, sačuvajte punu vrednost tačno onako kako je navedena. Gde je to moguće, koristite tekstualno polje promenljive ili neograničene dužine.
Kada vaš sistem čuva Shop Cash vrednosti autorizacije, pratite sledeće smernice:
- Ne skraćujte vrednost na kratku fiksnu dužinu, kao što je 50 ili 100 znakova.
- Nemojte parsirati niti izvoditi značenje iz bilo kog dela vrednosti.
- Nemojte koristiti vrednost autorizacije za identifikaciju transakcija za API operacije naplate, poništavanja ili povraćaja sredstava.
Skraćene vrednosti autorizacije mogu dovesti do neuspešnog uvoza od trećih strana ili neuspešne dalje obrade u ERP i OMS sistemima.
Da biste podržali naplate, poništavanja i povraćaje sredstava putem Admin API-ja, sačuvajte ID-ove transakcija porudžbine i relacije sa nadređenim transakcijama. Admin API operacije naplate i poništavanja identifikuju transakciju autorizacije pomoću parentTransactionId. Operacije povraćaja sredstava identifikuju transakciju naplate koju je moguće refundirati pomoću parentId.
Zahtevi za transakcije povraćaja sredstava
Kada aplikacija ili integracija izda Shop Cash povraćaj sredstava putem API-ja, povraćaj sredstava mora biti dodeljen Shop Cash transakciji naplate, a ne Shop Cash transakciji autorizacije. Povraćaji sredstava u odnosu na transakciju autorizacije se odbijaju.
Aplikacije za povraćaje sredstava i rukovaoci webhook-om bi trebalo da identifikuju refundabilnu Shop Cash transakciju naplate, izračunaju preostali refundabilni iznos za tu naplatu i kreiraju povraćaj sredstava za ID te transakcije naplate.
Napomene o API-ju i izvozu
Kada koristite Admin API, izvoze porudžbina, izvoze isplata ili izvoze aplikacija trećih strana, tretirajte Shop Cash kao podatke o plaćanju. U zavisnosti od izvoza ili API resursa koji koristite, informacije o opciji Shop Cash mogu biti predstavljene kroz način plaćanja, mrežni prolaz, transakciju porudžbine, transakciju isplate i podatke o povraćaju sredstava.
Kada gradite ili ažurirate integraciju, sačuvajte sledeće informacije za porudžbine koje uključuju Shop Cash:
- ID porudžbine i naziv porudžbine.
- Način plaćanja ili gateway vrednost, kao što je
shop_cashgde je to dostupno. - ID-ovi transakcija porudžbine za svaku transakciju plaćanja.
- Vrsta i status transakcije, kao što su autorizacija, naplata, povraćaj sredstava ili poništavanje.
- Iznos i valuta transakcije.
- Relacije nadređene transakcije, kada su dostupne.
- ID-ovi plaćanja, tamo gde su dostupni.
- Pune vrednosti autorizacije, ako ih vaš sistem uvozi.
- ID-ovi isplata i ID-ovi transakcija stanja kada sravnjujete isplate.
- ID-ovi transakcija povraćaja sredstava kada sravnjujete povraćaje.
Za detalje o dostupnim poljima za Admin API pogledajte dokumentaciju za programere Admin API order transaction. Izbegavajte oslanjanje na zastarela polja kao što je OrderTransaction.authorizationCode za nove integracije.
Primer oblika transakcije porudžbine
Sledeći pojednostavljeni primer prikazuje porudžbinu od 100 USD gde je 75 USD plaćeno putem usluge Shopify Payments, a 25 USD putem programa Shop Cash. Vrednosti su samo 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
}
]
}Po čemu se Shop Cash razlikuje od sličnih vrednosti porudžbina
Shop Cash može izgledati slično drugim plaćanjima ili promotivnim vrednostima, ali vaši sistemi treba da tretiraju svaku vrednost zasebno:
| Vrednost | Kako se tretira |
|---|---|
| Shop Cash | Način plaćanja koji se pojavljuje kao transakcija porudžbine sa vrednošću shop_cash gde su dostupne vrednosti mrežnog prolaza. |
| Poklon kartica | Zaseban način plaćanja. Poklon kartice nisu isto što i Shop Cash i ne proizvode isplatne transakcije za Shop Cash. |
| Popust | Smanjenje cene porudžbine ili stavke. Shop Cash nije popust i ne umanjuje međuzbir porudžbine, poreze, isporuku niti popuste. |
| Kredit prodavnice | Zaseban način plaćanja sa sopstvenom glavnom knjigom i ponašanjem saldiranja. Kredit prodavnice nije zamenljiv programom Shop Cash. |
| Vrednost ponude ili kampanje za Shop | Promotivna vrednost koju finansira trgovac, a koja može biti uključena u istu transakciju porudžbine shop_cash. Trenutni troškovi kampanje naplaćuju se na vašem Shopify računu. Istorijske aktivnosti kampanje pre januara 2026. godine mogu se pojaviti u isplatnim transakcijama kampanje. |
Kontrolna lista integracije programa Shop Cash
Pre nego što se oslonite na sistem treće strane za porudžbine koje uključuju Shop Cash, potvrdite sledeće zahteve:
- Shop Cash je mapiran kao način plaćanja.
- Porudžbine sa programima Shop Cash i Shop Pay uvoze se sa oba načina plaćanja.
- Logika načina plaćanja ne podrazumeva jedan način plaćanja po porudžbini.
- Vrednosti autorizacije se čuvaju kao dugi neprozirni stringovi i ne skraćuju se.
- Logika povraćaja sredstava može izvršiti povraćaj sredstava za odgovarajuću transakciju preuzimanja.
- Logika povraćaja sredstava može da vrati sredstva na odgovarajuće načine plaćanja.
- Sravnjivanje isplate može da obuhvati kredit za Shop Cash, povraćaj sredstava i tipove transakcija kampanje.
- Realizacija, računovodstvo i tokovi posla povraćaja ne tretiraju Shop Cash kao popust.
Ako koristite više sistema, obavite ovaj pregled za svaki sistem koji prima podatke o porudžbini, transakciji, isplati, realizaciji, povraćaju sredstava ili povraćaju.