Je systemen voorbereiden op Shop Cash

Voordat je voor fulfilment-, boekhoudings-, reconciliatie- of retourworkflows op Shop Cash vertrouwt, moet je controleren of elk systeem dat bestellings-, betalings-, uitbetalings-, terugbetalings- of retourgegevens ontvangt, Shop Cash correct kan verwerken.

Shop Cash is een betaalmethode. Het is geen korting, cadeaubon of winkeltegoed. Systemen die uitgaan van één betaalmethode per bestelling, één uitbetalingsrij per bestelling of korte autorisatiewaarden hebben mogelijk een update nodig voordat je Shop Cash-bestellingen op schaal verwerkt.

Checklist voor integratiegereedheid

Controleer de volgende vereisten voordat je Shop Cash-workflows met systemen van externe partijen lanceert:

  • Je ERP-, OMS-, fulfilment-, boekhoud- en retoursystemen kunnen meer dan één betaalmethode per bestelling accepteren.
  • shop_cash is toegewezen als betaalmethode waar gatewaywaarden beschikbaar zijn.
  • Shop Cash wordt niet behandeld als korting, cadeaubon of winkeltegoed.
  • De autorisatiewaarde wordt opgeslagen als een ondoorzichtige tekenreeks met een variabele lengte van minimaal 1024 tekens. Gebruik indien mogelijk een onbegrensd tekstveld.
  • Vastleggingen, ongeldigverklaringen en terugbetalingen worden geïdentificeerd door een transactie-ID in plaats van door de autorisatiewaarde. Admin API-bewerkingen voor vastleggen en ongeldig verklaren gebruiken parentTransactionId, en terugbetalingsbewerkingen gebruiken parentId.
  • Je systemen parseren, decoderen, normaliseren, hashen of kappen Shop Cash-autorisatiewaarden niet af.
  • Je systemen kunnen gegroepeerde uitbetalingen verwerken, waarbij één shop_cash_credit-rij meerdere bestellingen kan vertegenwoordigen.
  • Je reconciliatieworkflow gaat er niet van uit dat één bestelling gelijk is aan één uitbetalingsrij.
  • Je reconciliatieworkflow kan verwerken dat het Shop Cash-gedeelte en het gedeelte voor kaarten of Shop Pay-termijnbetalingen op verschillende uitbetalingen worden verrekend.
  • Je terugbetalingsworkflow kan gedeeltelijke terugbetalingen via kaarten of Shop Pay-termijnbetalingen en Shop Cash verwerken.
  • Terugbetalingsapps kunnen de Shop Cash-vastleggingstransactie terugbetalen, niet de autorisatietransactie.
  • Als je voor januari 2026 Shop Campaigns hebt gedraaid, verwerkt je financiële workflow de historische shop_cash_campaign_billing_debit en gerelateerde campagnefacteringsrijen apart van de bestellingsomzet. Campagnekosten vanaf januari 2026 worden in plaats daarvan in rekening gebracht op je Shopify-factuur.

Testopties en -beperkingen

Het testen van Shop Cash heeft beperkingen omdat Shop Cash afhankelijk is van Shop-kopersaccounts, Shop Cash-saldo's, Shopify Payments en de Shop Cash-verrekeningsinfrastructuur.

De meest betrouwbare manier om een enterprise-integratie end-to-end te valideren, is door een productiebestelling met een lage waarde via Shop te plaatsen en deze vervolgens terug te betalen. Dit creëert productieachtige bestellingstransacties, vastleggingsgegevens, uitbetalingsactiviteit, terugbetalingstransacties en terugbetalingsdebetactiviteit die doorloopt in het Shopify-beheercentrum, Admin API-gegevens, uitbetalingsexports en uitbetalings-API-gegevens.

Development stores kunnen helpen bij het valideren van sommige API-veldvormen en toewijzingslogica, maar ze voeren niet op betrouwbare wijze de volledige checkout vanuit Shop, het kopersaldo en de verrekeningsflow uit. De testmodus en de Bogus-gateway creëren geen productieachtige Shop Cash-uitbetalingsrijen omdat ze geen live Shopify Payments-verrekeningsflow gebruiken.

Wat je zelf kunt testen

Je kunt doorgaans de volgende workflows testen met een productiebestelling van lage waarde die vanuit Shop wordt gestart:

  • Opname van bestellingen voor een bestelling met meerdere betaalmethoden die Shop Cash en Shop Pay of Shop Pay-termijnbetalingen bevat.
  • ERP- of OMS-toewijzing voor shop_cash.
  • Opslag van de volledige Shop Cash-autorisatiewaarde.
  • Volledige en gedeeltelijke terugbetalingen van de bestelling.
  • Opname van shop_cash_refund_debit-uitbetalingsactiviteit.
  • Uitbetalingsreconciliatie voor Shop Cash-tegoeden.
  • Pre-order- of vastleggen-bij-fulfilment-gedrag, als je winkel vertraagde vastlegging gebruikt.
  • Afhandeling van retourapps voor bestellingen met meer dan één betaalmethode.

Als je test in productie, gebruik dan een bestelling van lage waarde en volg de interne testbestellings- en terugbetalingsprocedures van je winkel.

Waarvoor Shopify Support mogelijk nodig is

Neem contact op met Shopify Support als je hulp nodig hebt bij de volgende scenario's:

  • De beschikbaarheid van Shop Cash controleren voor een markt die in uitrol is.
  • Een mislukte Shop Cash-vastlegging of -terugbetaling onderzoeken.
  • Een ontbrekende Shop Cash-uitbetalingstransactie onderzoeken na je normale uitbetalingsritme plus één extra uitbetalingscyclus.
  • Controleren of een ongeldig verklaarde of verlopen Shop Cash-autorisatie opnieuw kan worden geautoriseerd.
  • Een lancering plannen voor een complexe ERP-, OMS-, pre-order- of fulfilmentworkflow.

Voer de volgende controles uit voordat je het Shop Cash-bestellingsvolume opschaalt:

  • De toewijzing van betaalmethoden in ERP en OMS is geïmplementeerd en geverifieerd voor shop_cash.
  • Een voorbeeld van een Shop Cash-bestelling wordt end-to-end opgenomen, inclusief autorisatie- en vastleggingstransacties.
  • Een Shop Cash-uitbetalingstegoed als voorbeeld wordt gereconcilieerd met de bronbestelling of -bestellingen.
  • Een Shop Cash-terugbetaling als voorbeeld is verwerkt en gereconcilieerd met de terugbetalingsdebet.
  • Gegroepeerde Shop Cash-uitbetalingsrijen worden ondersteund of hebben een handmatig reconciliatieproces.
  • Toewijzing van gedeeltelijke terugbetalingen wordt begrepen door je support- en financiële teams.
  • Gedrag voor pre-orders, handmatig vastleggen en vastleggen-bij-fulfilment is gevalideerd, indien van toepassing.
  • Retourapps kunnen de juiste Shop Cash-vastleggingstransactie identificeren en terugbetalen.
  • Support- en financiële teams kennen het verschil tussen het Shop Cash-saldo van de klant, Shop-aanbiedingen en factureringsactiviteit van Shop Campaigns.

Zie Shop Cash-bestellingsgegevens en integraties van externe partijen voor de vereisten van de API en bestellingsgegevens. Zie Shop Cash-uitbetalingen reconciliëren voor de uitbetalingsvereisten.