Bestillingsdata for Shop Cash og tredjepartsintegrasjoner

Når en kunde bruker Shop Cash på en bestilling, behandles Shop Cash som en betalingsmåte. Det er ikke en rabatt, et gavekort eller butikkvaluta. Eventuell gjenværende bestillingssaldo betales med Shop Pay eller Avdrag via Shop Pay.

Hvis en kunde for eksempel bruker 25 USD i Shop Cash på en bestilling på 100 USD, inkluderer bestillingen en Shop Cash-betaling på 25 USD og en Shop Pay-betaling på 75 USD. Bestillingsdataene kan inkludere mer enn én betalingsmåte for samme bestilling.

Shop Cash vises som en bestillingstransaksjon med gateway-verdien shop_cash der gateway-verdier er tilgjengelige. Shop Cash-transaksjonen følger den vanlige transaksjonslivssyklusen, som autorisasjon, trekk, annullering og refusjon. Shop Cash bruker ikke en kombinert salgstransaksjonstype.

Hvis kunden også bruker et Shop-tilbud fra en Shop Campaign, inkluderes den kampanjefinansierte verdien i det samme shop_cash-bestillingstransaksjonsbeløpet. Delene fra kjøpers saldo og kampanjefinansiering representeres ikke som separate bestillingstransaksjoner. Fra og med januar 2026 belastes kampanjekostnader på Shopify-fakturaen din i stedet for å trekkes fra utbetalingene, så kampanjefaktureringstransaksjoner i utbetalingsaktivitet gjelder kun for kampanjer som ble kjørt før denne datoen. For mer informasjon, se Gebyrer, Shop Campaigns og Shop Cash.

Tredjepartssystemer som importerer bestillinger, transaksjoner, innbetalinger, distribusjoner, refusjoner eller returer, må gjenkjenne Shop Cash som en betalingsmåte. Hvis et system ikke gjenkjenner Shop Cash, kan bestillinger som inkluderer Shop Cash mislykkes ved import, importeres med ufullstendige betalingsdata eller kreve manuell tilordning.

Gå gjennom følgende krav med leverandøren av tredjepartssystemet:

• Systemet støtter mer enn én betalingsmåte på en bestilling.
• Systemet kan tilordne shop_cash som en betalingsmåte.
• Systemet behandler ikke Shop Cash som en rabatt, et gavekort eller butikkvaluta.
• Systemet lagrer bestillingstransaksjons-ID-en for hver autorisasjon, hvert trekk, hver annullering og hver refusjon av Shop Cash.
• Systemet lagrer den fullstendige Shop Cash-autorisasjonsverdien uten å avkorte den, hvis verdien er inkludert i dataene systemet importerer.
• Systemet behandler autorisasjonsverdier som ugjennomsiktige strenger og verken parser, dekoder, normaliserer, hasher eller utleder mening fra dem.
• Systemet kan behandle refusjoner som returnerer midler til både Shop Pay og Shop Cash.
• Systemet kan stemme av Shop Cash-utbetalingstransaksjoner separat fra kortbetalingstransaksjoner.
• Systemet antar ikke at transaksjoner returneres i en bestemt rekkefølge.

Hvis tredjepartssystemet antar at hver bestilling kun har én betalingsmåte, må du kontakte leverandøren før du behandler Shop Cash-bestillinger gjennom dette systemet.

Autorisasjonsverdien på en Shop Cash-transaksjon er en ugjennomsiktig streng med variabel lengde. Den er ikke en kort autorisasjonskode for kort, og den er ikke lesbar for mennesker.

Hvis ditt ERP-, OMS- eller et annet tredjepartssystem importerer Shop Cash-autorisasjonsverdier, må du lagre den fullstendige verdien nøyaktig slik den er oppgitt. Bruk et tekstfelt med variabel lengde eller uten begrensning der det er mulig.

Følg disse retningslinjene når systemet lagrer Shop Cash-autorisasjonsverdier:

• Ikke avkort verdien til en kort fast lengde, som 50 eller 100 tegn.
• Ikke pars eller utled mening fra noen del av verdien.
• Ikke bruk autorisasjonsverdien til å identifisere transaksjoner for API-operasjonene for trekk, annullering eller refusjon.

Avkortede autorisasjonsverdier kan føre til at tredjepartsimporter eller påfølgende ERP- og OMS-behandling mislykkes.

For å støtte trekk, annulleringer og refusjoner via Admin API, må du lagre bestillingstransaksjons-ID-er og overordnede transaksjonsforhold. Admin API-operasjonene for trekk og annullering identifiserer autorisasjonstransaksjonen med parentTransactionId. Refusjonsoperasjoner identifiserer den refunderbare trekktransaksjonen med parentId.

Når en app eller integrasjon utsteder en Shop Cash-refusjon via API-et, må refusjonen være underordnet Shop Cash-trekktransaksjonen, ikke Shop Cash-autorisasjonstransaksjonen. Refusjoner mot autorisasjonstransaksjonen avvises.

Refusjonsapper og webhook-håndterere bør identifisere den refunderbare Shop Cash-trekktransaksjonen, beregne det gjenværende refunderbare beløpet for det trekket, og opprette refusjonen mot ID-en for trekktransaksjonen.

Når du bruker Admin API, bestillingseksporter, utbetalingseksporter eller eksporter fra tredjepartsapper, må du behandle Shop Cash som betalingsinformasjon. Avhengig av eksport- eller API-ressursen du bruker, kan Shop Cash-informasjon være representert gjennom betalingsmåte, gateway, bestillingstransaksjon, utbetalingstransaksjon og refusjonsdata.

Når du bygger eller oppdaterer en integrasjon, må du lagre følgende informasjon for bestillinger som inkluderer Shop Cash:

• Ordrenummer og ordrenavn.
• Betalingsmåte eller gatewayverdi, for eksempel shop_cash der dette er tilgjengelig.
• Ordretransaksjons-ID-er for hver betalingstransaksjon.
• Transaksjonstype og -status, som autorisasjon, heving, refusjon eller annullering.
• Transaksjonsbeløp og valuta.
• Relasjoner for overordnede transaksjoner, når det er tilgjengelig.
• Betalings-ID-er der det er tilgjengelig.
• Fullstendige autorisasjonsverdier, dersom systemet ditt importerer disse.
• Utbetalings-ID-er og saldotransaksjons-ID-er når du stemmer av utbetalinger.
• Refusjonstransaksjons-ID-er når du stemmer av returer.

For mer informasjon om tilgjengelige Admin API-felt, se utviklerdokumentasjonen for Admin API order transaction. Unngå å basere deg på utdaterte felt som OrderTransaction.authorizationCode for nye integrasjoner.

Følgende forenklede eksempel viser en bestilling på 100 USD der 75 USD er betalt gjennom Shopify Payments og 25 USD gjennom Shop Cash. Verdiene er kun illustrerende.

{
  "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 kan se ut som andre betalings- eller kampanjeverdier, men systemene dine bør behandle hver verdi separat:

Før du lener deg på et tredjepartssystem for bestillinger som inkluderer Shop Cash, må du bekrefte følgende krav:

• Shop Cash er tilordnet som en betalingsmåte.
• Bestillinger med Shop Cash og Shop Pay importeres med begge betalingsmåter.
• Logikk for betalingsmåter forutsetter ikke én betalingsmåte per bestilling.
• Autorisasjonsverdier lagres som lange, ugjennomsiktige strenger og blir ikke avkortet.
• Refusjonslogikken kan refundere riktig hevingstransaksjon.
• Refusjonslogikken kan returnere midler til de riktige betalingsmåtene.
• Avstemming av utbetalinger kan redegjøre for transaksjonstyper for Shop Cash-kredit, -refusjon og -kampanje.
• Arbeidsflyter for distribusjon, regnskap og retur behandler ikke Shop Cash som en rabatt.

Hvis du bruker flere systemer, må du fullføre denne gjennomgangen for hvert system som mottar bestillings-, transaksjons-, utbetalings-, distribusjons-, refusjons- eller returdata.