Ordredata for Shop Cash og tredjepartsintegrationer

Når en kunde bruger Shop Cash på en ordre, behandles Shop Cash som en betalingsmetode. Det er ikke en rabat, et gavekort eller et tilgodebevis. En eventuel resterende ordresaldo betales med Shop Pay eller Shop Pay Afbetaling.

Hvis en kunde f.eks. bruger 25 USD i Shop Cash på en ordre til 100 USD, indeholder ordren en Shop Cash-betaling på 25 USD og en Shop Pay-betaling på 75 USD. Dine ordredata kan indeholde mere end én betalingsmetode for den samme ordre.

Shop Cash vises som en ordretransaktion med gatewayværdien shop_cash, hvor gatewayværdier er tilgængelige. Shop Cash-transaktionen følger den almindelige transaktionslivscyklus, som f.eks. autorisation, hævning, annullering og refusion. Shop Cash bruger ikke en kombineret salgstransaktionstype.

Hvis kunden også bruger et Shop-tilbud fra en Shop Campaign, inkluderes den kampagnefinansierede værdi i det samme shop_cash-beløb for ordretransaktionen. Delene for købersaldo og kampagnefinansiering vises ikke som separate ordretransaktioner. Fra og med januar 2026 debiteres kampagneudgifter på din Shopify-faktura i stedet for at blive trukket fra dine udbetalinger, så transaktioner for kampagnefakturering i udbetalingsaktiviteten gælder kun for kampagner, der blev afviklet før den dato. Du kan finde flere oplysninger under Gebyrer, Shop Campaigns og Shop Cash.

Tredjepartssystemer, der importerer ordrer, transaktioner, betalinger, klargøringer, refusioner eller returneringer, skal genkende Shop Cash som en betalingsmetode. Hvis et system ikke genkender Shop Cash, kan importen af ordrer med Shop Cash mislykkes, de kan blive importeret med ufuldstændige betalingsdata eller kræve manuel tilknytning.

Gennemgå følgende krav med udbyderen af dit tredjepartssystem:

• Systemet understøtter mere end én betalingsmetode på samme ordre.
• Systemet kan tilknytte shop_cash som en betalingsmetode.
• Systemet behandler ikke Shop Cash som en rabat, et gavekort eller et tilgodebevis.
• Systemet gemmer id'et for ordretransaktionen for hver autorisation, hævning, annullering og refusion med Shop Cash.
• Systemet gemmer den fulde autorisationsværdi for Shop Cash uden at afkorte den, hvis værdien er inkluderet i de data, som systemet importerer.
• Systemet behandler autorisationsværdier som uigennemsigtige strenge og hverken analyserer, afkoder, normaliserer, hasher eller udleder betydning af dem.
• Systemet kan behandle refusioner, der returnerer midler til både Shop Pay og Shop Cash.
• Systemet kan afstemme udbetalingstransaktioner for Shop Cash adskilt fra transaktioner for kortbetalinger.
• Systemet antager ikke, at transaktioner returneres i en bestemt rækkefølge.

Hvis dit tredjepartssystem antager, at hver ordre kun har én betalingsmetode, skal du kontakte udbyderen, før du behandler Shop Cash-ordrer i dette system.

Autorisationsværdien for en Shop Cash-transaktion er en uigennemsigtig streng af variabel længde. Det er ikke en kort autorisationskode til et kort, og den er ikke læsbar for mennesker.

Hvis dit ERP, OMS eller et andet tredjepartssystem importerer autorisationsværdier for Shop Cash, skal den fulde værdi gemmes præcis som angivet. Brug et tekstfelt af variabel længde eller uden begrænsning, hvor det er muligt.

Når dit system gemmer autorisationsværdier for Shop Cash, skal du følge disse retningslinjer:

• Afkort ikke værdien til en kort, fast længde, f.eks. 50 eller 100 tegn.
• Analyser eller udled ikke betydning af nogen del af værdien.
• Brug ikke autorisationsværdien til at identificere transaktioner for API-handlinger i forbindelse med hævning, annullering eller refusion.

Afkortede autorisationsværdier kan medføre, at tredjepartsimporter eller efterfølgende behandling i ERP og OMS mislykkes.

Hvis du vil understøtte hævninger, annulleringer og refusioner via Admin API, skal du gemme id'er for ordretransaktioner og relationer for overordnede transaktioner. Handlinger for hævning og annullering i Admin API identificerer autorisationstransaktionen med parentTransactionId. Refusionshandlinger identificerer den refunderbare hævningstransaktion med parentId.

Når en app eller integration udsteder en Shop Cash-refusion via API'en, skal refusionen være underordnet Shop Cash-hævningstransaktionen, ikke autorisationstransaktionen for Shop Cash. Refusioner mod autorisationstransaktionen afvises.

Refusionsapps og webhook-handlere bør identificere den refunderbare Shop Cash-hævningstransaktion, beregne det resterende refunderbare beløb for denne hævning og oprette refusionen mod hævningstransaktionens id.

Når du bruger Admin API, eksport af ordrer, eksport af udbetalinger eller eksport fra tredjepartsapps, skal du behandle Shop Cash som betalingsdata. Afhængigt af den eksport eller API-ressource, du bruger, kan oplysninger om Shop Cash repræsenteres via betalingsmetode, gateway, ordretransaktion, udbetalingstransaktion og refusionsdata.

Når du opbygger eller opdaterer en integration, skal du gemme følgende oplysninger for ordrer, der omfatter Shop Cash:

• Ordre-id og ordrenavn.
• Værdi for betalingsmetode eller gateway, f.eks. shop_cash, hvor det er tilgængeligt.
• Ordretransaktions-id'er for hver betalingstransaktion.
• Transaktionstype og -status, f.eks. godkendelse, registrering, refusion eller annullering.
• Transaktionsbeløb og -valuta.
• Relationer til overordnede transaktioner, når de er tilgængelige.
• Betalings-id'er, hvor de er tilgængelige.
• Fuldstændige godkendelsesværdier, hvis dit system importerer dem.
• Udbetalings-id'er og saldotransaktions-id'er, når du afstemmer udbetalinger.
• Refusionstransaktions-id'er, når du afstemmer returneringer.

Du kan finde flere oplysninger om tilgængelige felter i Admin API i udviklerdokumentationen til ordretransaktioner i Admin API. Undgå at basere nye integrationer på udfasede felter som f.eks. OrderTransaction.authorizationCode.

Følgende forenklede eksempel viser en ordre på 100 USD, hvor 75 USD er betalt via Shopify Payments, og 25 USD er betalt via Shop Cash. Værdierne er kun vejledende.

{
  "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 minde om andre betalings- eller kampagneværdier, men dine systemer bør behandle hver enkelt værdi separat:

Før du baserer ordrer med Shop Cash på et tredjepartssystem, skal du bekræfte følgende krav:

• Shop Cash er tilknyttet som en betalingsmetode.
• Ordrer med Shop Cash og Shop Pay importeres med begge betalingsmetoder.
• Logik for betalingsmetoder forudsætter ikke kun én betalingsmetode pr. ordre.
• Godkendelsesværdier gemmes som lange, uigennemsigtige strenge og afkortes ikke.
• Refusionslogik kan refundere den korrekte registreringstransaktion.
• Refusionslogik kan returnere midler til de korrekte betalingsmetoder.
• Afstemning af udbetalinger kan tage højde for transaktionstyper relateret til Shop Cash-kredit, refusioner og kampagner.
• Workflows til klargøring, regnskab og returneringer behandler ikke Shop Cash som en rabat.

Hvis du bruger flere systemer, skal du gennemføre denne gennemgang for hvert system, der modtager data om ordrer, transaktioner, udbetalinger, klargøring, refusioner eller returneringer.