Skip to main content

Troubleshooting & Reference · Article 7.3

„Zwrot pokazuje się jako Zlecony, ale Stripe mówi, że się powiódł"

Nota kredytowa utknęła w statusie „Zlecony", podczas gdy panel Stripe pokazuje zwrot jako `succeeded`. Prawie zawsze jest to brakująca subskrypcja webhooka na koncie Connect; jedno kliknięcie `Odśwież status` rozwiązuje problem.

Zwroty Stripe Connect polegają na webhookach, aby utrzymać widok Clozo zsynchronizowany z rzeczywistym stanem Stripe. Gdy subskrypcja webhooka jest błędnie skonfigurowana lub przejściowo zawodzi, zwrot „kończy się" po stronie Stripe, ale Clozo jeszcze o tym nie wie. Przycisk Odśwież status to ręczna reconcyliacja — można go klikać tyle razy, ile chcesz.

Step by step

  1. Potwierdź widok Stripe.

    Otwórz panel Stripe → Zwroty → wyszukaj identyfikator zwrotu. Jeśli status to succeeded, kontynuuj.

  2. Kliknij Odśwież status

    na nocie kredytowej w Clozo (strona Not kredytowych lub szczegóły oferty).

  3. Obserwuj zmianę statusu.

    W ciągu 2–3 sekund nota kredytowa powinna przejść do Powiódł się i zostanie wysłany e-mail o zakończeniu zwrotu.

Why this works this way

Zwroty przechodzą przez cztery stany: ZleconyPrzetwarzanyPowiódł się (lub Nie powiódł się). Maszyna stanów przesuwa się do przodu, gdy dociera odpowiedni webhook Stripe — refund.created, refund.updated, charge.refunded. Jeśli brakuje jakiejkolwiek subskrypcji na panelu konta Connect, odpowiednie przejście stanu zatrzymuje się.

W maju 2026 r. ([D-115] / BUG-PROD-009) zidentyfikowaliśmy, że niektóre konta Connect utworzone przed poprawką nie miały refund.updated w zestawie subskrypcji. Poprawka wylądowała w dwóch częściach: (1) domyślny szablon subskrypcji zawiera teraz refund.updated dla wszystkich nowych kont, (2) migracja uzupełniła subskrypcje dla istniejących kont. Jeśli dołączyłeś przed majem 2026 i nie przekazałeś poprawki, przycisk Odśwież status wypełnia tę lukę.

Odśwież status wywołuje API Stripe (stripe.Refund.retrieve(refund_id)) i stosuje zwrócony stan bezpośrednio. Nie ma ryzyka podwójnego przetwarzania — lokalna maszyna stanów jest idempotentna na tym samym stanie docelowym.

Troubleshooting

Keep reading

„Zwrot pokazuje się jako Zlecony, ale Stripe mówi, że się powiódł" · Help · Clozo