Stripe Connect zaten onboarded im her tiklamada yine Stripe e yonlendiriyor — AccountLink burn (PR #631 HHH F4)

Eskisehir Odunpazari 38-yas Eskisehir Ciborek + Burma Tatli 50-cover 11-yil Anadolu tatlicisi sahibi Selcuk thMenu Pro 14 ay affiliate program 8 ay handle selcuk-cibo Connect onboarding 6 ay once tamamlandi ilk komisyon alindi. Pazartesi sabah affiliate dashboard Stripe Connect Status sekme komisyon raporu icin tikladi Stripe sayfasina yonlendirildi Stripe Youre all set nothing to do. Selcuk saskin onboarded ben niye yonlendirildim? Stripe dashboard pending balance + payment history + KYC tam ama Connect onboarded bir kez tamamlanir surekli AccountLink fresh redirect mantiksiz. Support engineering UX papercut. 3 yanlis teori (1) account.updated webhook onboarding sifirliyor — query stable charges_enabled+details_submitted true webhook delivery log 90 day no code path nulling onboarded_at HHH F1 ayri bug; (2) /api/affiliate/connect-status fresh AccountLink her cagri — dogru ama eksik minting yanlis degil unconditional minting yanlis pre-flight eksik; (3) frontend client-side cache — Band-Aid root cause backend pre-flight check. Adli analiz apps/web-affiliate/src/app/api/connect/onboard/route.ts (1) affiliate tikla POST connect/onboard (2) stripe.accountLinks.create type account_onboarding (3) Stripe fresh AccountLink + return_url + refresh_url (4) server redirect URL (5) Stripe sayfa onboarding tamam all set otherwise form. Pattern affiliate her tikladiginda fresh AccountLink istek AccountLink TTL 5 dakika tikla -> Stripe API -> yeni URL -> redirect zincir her seferinde. Sonuc (a) Stripe API quota burn 100 req/sec per account ratelimit slot her tikla peak season 50+ tikla/day; (b) UX papercut onboarded Stripe sayfa all set click back onboarding mi kirildi panik; (c) latency 2-3sn Stripe round-trip + Stripe page load onboarded affiliate ziyan. PR #631 batch HHH F4 kucuk temiz fix /api/connect/onboard endpoint Stripe accountLinks.create cagrisindan ONCE Stripe accounts.retrieve mevcut state kontrol. Eger account.details_submitted=true && account.charges_enabled=true -> AccountLink minting atla 200 OK status already_onboarded stripe_account_id. Frontend 200 OK Status Onboarded rozet redirect ATMAZ. Affiliate View on Stripe linkine tikla dashboard.stripe.com/<env>/connect/accounts/<account_id>. Trade-off accounts.retrieve hala Stripe API read-only ama accountLinks.create 3x daha hafif rate-limit kategorisi farkli + 24h KV cache stripe:account:<id>:state details_submitted charges_enabled cache hit no API. account.updated webhook cache invalidate. Production audit son 90 gun accountLinks.create 4712 cagri 3891 %82 onboarded affiliate icin. Post-deploy 7-day (a) accountLinks.create gunluk 50 -> 9 cache hit %78; (b) accounts.retrieve 0 -> 12/gun; (c) Stripe API quota burn %80 dustu; (d) ortalama Connect Status page load 2.8s -> 0.4s. Selcuk otomatik email bug fix shipped Connect status button artik dogru 1-ay Pro credit Twitter 8 saat fix shipped Turkiye standart degil 1.2k engagement. Cailean Glasgow Merchant City 36-yas The Glasgow Smokehouse 48-cover 7-yil scoth fume et affiliate handle glasgow-smoke 7 ay onboarded ayni sorun 3 hafta paralel ticket. Pattern external API state-change request once mevcut state kontrol hedef state saglanmissa short-circuit 200 OK Stripe Customer Portal session + Wise quote + OAuth refresh hepsinde gecerli. Implementation checklist (1) idempotent confirm; (2) pre-flight read API 3-10x daha hafif; (3) KV 24h cache + webhook invalidate; (4) cache hit short-circuit; (5) cache miss pre-flight; (6) frontend rozet redirect ATMAZ. Sibling sweep /api/billing/portal-session + /api/wise/transfer-quote + /api/oauth/refresh (PR #526 HH already) Customer Portal cleanup PR #631 dahil. PR #631 referans.

İlgili makaleler