Údaje o objednávkach Shop Cash a integrácie tretích strán

Keď zákazník použije pri objednávke Shop Cash, Shop Cash sa považuje za spôsob platby. Nejde o zľavu, darčekovú kartu ani kredit v obchode. Zvyšný zostatok objednávky sa uhradí prostredníctvom služby Shop Pay alebo Splátky Shop Pay.

Napríklad, ak zákazník pri objednávke v hodnote 100 USD použije Shop Cash vo výške 25 USD, objednávka bude zahŕňať platbu cez Shop Cash vo výške 25 USD a platbu cez Shop Pay vo výške 75 USD. Údaje o objednávke môžu pre tú istú objednávku obsahovať viac ako jeden spôsob platby.

Shop Cash sa zobrazuje ako transakcia objednávky s hodnotou brány shop_cash všade tam, kde sú dostupné hodnoty brány. Transakcia Shop Cash nasleduje štandardný životný cyklus transakcie, ako je autorizácia, zachytenie, zneplatnenie a vrátenie peňazí. Shop Cash nepoužíva typ transakcie kombinovaného predaja.

Ak zákazník použije aj ponuku Shop z kampane Shop Campaigns, hodnota financovaná kampaňou sa zahrnie do rovnakej sumy transakcie objednávky shop_cash. Časť zostatku kupujúceho a časť financovaná kampaňou sa nezobrazujú ako samostatné transakcie objednávky. Od januára 2026 sa náklady na kampaň účtujú do vášho vyúčtovania Shopify namiesto toho, aby sa odpočítavali z výplat, takže transakcie vyúčtovania kampane v aktivite výplat sa týkajú iba kampaní, ktoré prebiehali pred týmto dátumom. Ďalšie informácie nájdete v časti Poplatky, Shop Campaigns a Shop Cash.

Systémy tretích strán, ktoré importujú objednávky, transakcie, platby, naplnenia, vrátenia peňazí alebo vrátenia, musia rozpoznať Shop Cash ako spôsob platby. Ak systém nerozpozná Shop Cash, import objednávok so Shop Cash môže zlyhať, môžu sa importovať s neúplnými platobnými údajmi alebo si môžu vyžadovať manuálne mapovanie.

U poskytovateľa systému tretej strany si overte nasledujúce požiadavky:

• Systém dokáže pre jednu objednávku podporovať viac ako jeden spôsob platby.
• Systém dokáže namapovať shop_cash ako spôsob platby.
• Systém nepovažuje Shop Cash za zľavu, darčekovú kartu ani kredit v obchode.
• Systém ukladá ID transakcie objednávky pre každú autorizáciu, zachytenie, zneplatnenie a vrátenie peňazí Shop Cash.
• Systém ukladá celú hodnotu autorizácie Shop Cash bez jej skrátenia v prípade, že je táto hodnota súčasťou údajov importovaných systémom.
• Systém spracúva hodnoty autorizácie ako neprehľadné reťazce a neanalyzuje ich, nedekóduje, nenormalizuje, nehashuje ani z nich nevyvodzuje význam.
• Systém dokáže spracovať vrátenie peňazí tak, že vráti prostriedky do služby Shop Pay aj na účet Shop Cash.
• Systém dokáže odsúhlasiť transakcie výplaty Shop Cash oddelene od transakcií platby kartou.
• Systém nepredpokladá, že sa transakcie vracajú v určitom poradí.

Ak váš systém tretej strany predpokladá, že každá objednávka má len jeden spôsob platby, pred spracovaním objednávok Shop Cash v danom systéme kontaktujte jeho poskytovateľa.

Hodnota autorizácie transakcie Shop Cash je neprehľadný reťazec premenlivej dĺžky. Nejde o krátky autorizačný kód karty a nie je čitateľný pre ľudí.

Ak váš systém ERP, OMS alebo iný systém tretej strany importuje hodnoty autorizácie Shop Cash, uložte si celú hodnotu presne tak, ako je zadaná. Ak je to možné, použite textové pole s premenlivou dĺžkou alebo bez obmedzenia dĺžky.

Keď systém ukladá hodnoty autorizácie Shop Cash, postupujte podľa týchto pokynov:

• Neskracujte hodnotu na krátku pevnú dĺžku, napríklad na 50 alebo 100 znakov.
• Neanalyzujte ani nevyvodzujte význam zo žiadnej časti hodnoty.
• Nepoužívajte hodnotu autorizácie na identifikáciu transakcií pre operácie zachytenia, zneplatnenia ani vrátenia peňazí cez API.

Skrátené hodnoty autorizácie môžu spôsobiť zlyhanie importov tretích strán alebo následného spracovania v systémoch ERP a OMS.

Ak chcete podporovať zachytenia, zneplatnenia a vrátenia peňazí prostredníctvom rozhrania Admin API, ukladajte ID transakcií objednávok a vzťahy nadradených transakcií. Operácie zachytenia a zneplatnenia v rozhraní Admin API identifikujú transakciu autorizácie pomocou identifikátora parentTransactionId. Operácie vrátenia peňazí identifikujú transakciu vratného zachytenia pomocou identifikátora parentId.

Keď aplikácia alebo integrácia zadá vrátenie peňazí zo Shop Cash prostredníctvom rozhrania API, vrátenie peňazí musí byť naviazané na nadradenú transakciu zachytenia Shop Cash, nie na transakciu autorizácie Shop Cash. Vrátenia peňazí voči transakcii autorizácie budú zamietnuté.

Aplikácie na vrátenie peňazí a obslužné programy webhookov by mali identifikovať transakciu vratného zachytenia Shop Cash, vypočítať zostávajúcu vratnú sumu pre dané zachytenie a vytvoriť vrátenie peňazí voči ID transakcie zachytenia.

Pri používaní rozhrania Admin API, exportov objednávok, exportov výplat alebo exportov aplikácií tretích strán považujte Shop Cash za platobné údaje. V závislosti od použitého exportu alebo zdroja API sa informácie o Shop Cash môžu zobraziť v údajoch o spôsobe platby, bráne, transakcii objednávky, transakcii výplaty a vrátení peňazí.

Pri vytváraní alebo aktualizácii integrácie uložte nasledujúce informácie pre objednávky, ktoré obsahujú Shop Cash:

• ID objednávky a názov objednávky.
• Spôsob platby alebo hodnota brány, napríklad shop_cash (ak je k dispozícii).
• ID transakcie objednávky pre každú platobnú transakciu.
• Typ a stav transakcie, napríklad autorizácia, zachytenie, vrátenie peňazí alebo zneplatnenie.
• Suma a mena transakcie.
• Vzťahy nadradených transakcií, ak sú k dispozícii.
• ID platieb, ak sú k dispozícii.
• Úplné hodnoty autorizácie, ak ich váš systém importuje.
• ID výplat a ID transakcií zostatku pri odsúhlasovaní výplat.
• ID transakcií vrátenia peňazí pri odsúhlasovaní vrátení.

Podrobnosti o dostupných poliach rozhrania Admin API nájdete v dokumentácii pre vývojárov pre transakcie objednávok v rozhraní Admin API. Pri nových integráciách sa nespoliehajte na zastarané polia, ako je OrderTransaction.authorizationCode.

Nasledujúci zjednodušený príklad zobrazuje objednávku v hodnote 100 USD zaplatenú sumou 75 USD cez Shopify Payments a 25 USD cez Shop Cash. Hodnoty sú len ilustratívne.

{
  "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 sa môže podobať na iné platobné alebo propagačné hodnoty, no vaše systémy by mali každú hodnotu spracovávať samostatne:

Skôr než sa spoľahnete na systém tretej strany pri objednávkach obsahujúcich Shop Cash, overte tieto požiadavky:

• Shop Cash je namapovaný ako spôsob platby.
• Objednávky so Shop Cash a Shop Pay sa importujú s oboma spôsobmi platby.
• Logika spôsobu platby nepredpokladá len jeden spôsob platby na objednávku.
• Hodnoty autorizácie sa ukladajú ako dlhé neprehľadné reťazce a neskracujú sa.
• Logika vrátenia peňazí dokáže vrátiť prostriedky pre správnu transakciu zachytenia.
• Logika vrátenia peňazí dokáže vrátiť prostriedky na správne spôsoby platby.
• Odsúhlasenie výplat dokáže zohľadniť typy transakcií kreditu Shop Cash, vrátenia peňazí a kampane.
• Pracovné postupy naplnenia, účtovníctva a vrátenia nepovažujú Shop Cash za zľavu.

Ak používate viaceré systémy, vykonajte túto kontrolu pre každý systém, ktorý prijíma údaje o objednávkach, transakciách, výplatách, naplnení, vrátení peňazí alebo vráteniach.