Przygotuj swoje systemy do obsługi Shop Cash

Zanim uruchomisz przepływy pracy Shop Cash z systemami zewnętrznymi, upewnij się, że spełnione są następujące wymagania:

• Twoje systemy ERP, OMS, systemy realizacji, księgowości i zwrotów mogą akceptować więcej niż jedną metodę płatności w jednym zamówieniu.
• Wartość shop_cash jest zmapowana jako metoda płatności w miejscach, w których dostępne są wartości bramki.
• Metoda Shop Cash nie jest traktowana jako rabat, karta prezentowa ani kredyt sklepowy.
• Wartość autoryzacji jest przechowywana jako nieprzezroczysty ciąg znaków o zmiennej długości wynoszącej co najmniej 1024 znaki. Jeśli to możliwe, użyj nieograniczonego pola tekstowego.
• Rejestracje, unieważnienia i zwroty kosztów są identyfikowane na podstawie ID transakcji, a nie wartości autoryzacji. Operacje rejestracji i unieważniania przez Admin API używają parametru parentTransactionId, a operacje zwrotu kosztów – parentId.
• Twoje systemy nie przetwarzają, nie dekodują, nie normalizują, nie haszują ani nie obcinają wartości autoryzacji Shop Cash.
• Twoje systemy obsługują zgrupowane wypłaty, w których jeden wiersz shop_cash_credit może reprezentować wiele zamówień.
• Twój przepływ pracy dla uzgodnień nie zakłada, że jednemu zamówieniu odpowiada jeden wiersz wypłaty.
• Twój przepływ pracy dla uzgodnień obsługuje sytuację, w której część opłacona z Shop Cash oraz część opłacona kartą lub z Raty Shop Pay są rozliczane w różnych wypłatach.
• Twój przepływ pracy dla zwrotów kosztów może przetwarzać częściowe zwroty kosztów w transakcjach obejmujących opłaty kartą lub przez Raty Shop Pay oraz z Shop Cash.
• Aplikacje do zwrotów kosztów potrafią zwracać koszty z transakcji rejestracji Shop Cash, a nie z transakcji autoryzacji.
• Jeśli kampanie Shop Campaigns były przez Ciebie prowadzone przed styczniem 2026 r., Twój przepływ pracy w obszarze finansów przetwarza historyczne dane shop_cash_campaign_billing_debit i powiązane wiersze rozliczeń kampanii oddzielnie od przychodów z zamówień. Od stycznia 2026 r. koszty kampanii są zamiast tego doliczane do Twojego rachunku od Shopify.

Testowanie płatności Shop Cash podlega ograniczeniom, ponieważ zależy ona od kont kupujących w aplikacji Shop, sald Shop Cash, usługi Shopify Payments oraz infrastruktury rozliczeniowej Shop Cash.

Najbardziej niezawodnym sposobem na kompleksowe sprawdzenie integracji w przedsiębiorstwie jest złożenie zamówienia produkcyjnego o niskiej wartości w aplikacji Shop, a następnie dokonanie zwrotu jego kosztów. Generuje to zbliżone do produkcyjnych transakcje dla zamówień, dane o rejestracji, aktywność związaną z wypłatami, transakcje zwrotów kosztów i obciążenia zwrotami kosztów, które przepływają przez panel administracyjny Shopify, dane z Admin API, eksporty wypłat i dane z API wypłat.

Sklepy w fazie rozwoju mogą pomóc w weryfikacji niektórych formatów pól API i logiki mapowania, ale nie służą do niezawodnego testowania pełnego przepływu realizacji zakupu zapoczątkowanego w aplikacji Shop, salda kupującego i rozliczeń. Tryb testowy i bramka Bogus nie tworzą wierszy wypłat Shop Cash odpowiadających rzeczywistym warunkom produkcyjnym, ponieważ nie korzystają z pełnego przepływu rozliczeń w usłudze Shopify Payments.

Zazwyczaj możesz przetestować następujące przepływy pracy za pomocą zamówienia produkcyjnego o małej wartości, zainicjowanego w aplikacji Shop:

• Przyjmowanie do systemu zamówienia z wieloma metodami płatności, które obejmuje Shop Cash i Shop Pay lub Raty Shop Pay.
• Mapowanie w systemie ERP lub OMS dla wartości shop_cash.
• Przechowywanie pełnej wartości autoryzacji Shop Cash.
• Całkowite i częściowe zwroty kosztów dla zamówienia.
• Rejestrowanie w systemie aktywności dotyczącej wypłat dla parametru shop_cash_refund_debit.
• Uzgodnienie wypłaty dla uznań w Shop Cash.
• Zachowanie podczas zamówień w przedsprzedaży lub rejestracji płatności na etapie realizacji, jeśli w Twoim sklepie używana jest opóźniona rejestracja.
• Obsługa aplikacji do zwrotów dla zamówień opłaconych za pomocą więcej niż jednej metody płatności.

Podczas testowania w środowisku produkcyjnym używaj zamówień o niskiej wartości i postępuj zgodnie z wewnętrznymi procedurami Twojego sklepu dotyczącymi zamówień testowych i zwrotów kosztów.

Skontaktuj się z Pomocą techniczną Shopify, jeśli potrzebujesz wsparcia w jednym z poniższych scenariuszy:

• Weryfikacja dostępności rozwiązania Shop Cash dla rynku, które jest na etapie wdrażania.
• Zbadanie nieudanej rejestracji płatności lub zwrotu kosztów dla Shop Cash.
• Zbadanie braku transakcji wypłaty z Shop Cash po upływie standardowego harmonogramu wypłat oraz jednego dodatkowego cyklu wypłaty.
• Sprawdzenie, czy unieważniona lub wygasła autoryzacja Shop Cash może zostać zautoryzowana ponownie.
• Planowanie uruchomienia złożonego przepływu pracy dla systemu ERP, OMS, zamówień w przedsprzedaży lub realizacji.

Przed zwiększeniem wolumenu zamówień opłacanych z Shop Cash wykonaj poniższe kontrole:

• Mapowanie metod płatności dla systemów ERP i OMS zostało wdrożone i zweryfikowane pod kątem wartości shop_cash.
• Przykładowe zamówienie opłacone w Shop Cash jest wprowadzane do systemu w całości — od początku do końca, włączając w to transakcje autoryzacji i rejestracji płatności.
• Przykładowe uznanie wypłaty z Shop Cash zostało uzgodnione z zamówieniem lub zamówieniami źródłowymi.
• Przykładowy zwrot kosztów Shop Cash został przetworzony i uzgodniony z odpowiednim obciążeniem za zwrot.
• Zgrupowane wiersze wypłat w Shop Cash są obsługiwane lub istnieje dla nich proces ręcznego uzgadniania.
• Zespoły pomocy technicznej i zespół odpowiedzialny za finanse w Twojej firmie wiedzą, na czym polega alokacja częściowych zwrotów kosztów.
• Zasady dotyczące zamówień w przedsprzedaży, ręcznej rejestracji oraz rejestracji na etapie realizacji są zweryfikowane (o ile mają zastosowanie).
• Aplikacje do zwrotów poprawnie identyfikują transakcję rejestracji w Shop Cash i potrafią zwrócić dla niej koszty.
• Zespoły pomocy technicznej oraz zespół finansowy znają różnicę pomiędzy saldem Shop Cash klienta, ofertami w aplikacji Shop a rozliczeniami operacji w usłudze Shop Campaigns.

Aby uzyskać informacje o wymaganiach dotyczących interfejsu API i danych o zamówieniach, zobacz sekcję Dane zamówień Shop Cash i integracje z systemami zewnętrznymi. Z kolei wymagania dotyczące wypłat opisano w sekcji Uzgadnianie wypłat z Shop Cash.