SÚGÓ › Számlázás

Webshop — saját Stripe-fiók bekötése (BYOK)

Hogyan kösd be a saját Stripe-fiókod a PromNET-webshopodba. Ez a kötelező mód — minden bevétel közvetlenül a TE Stripe-fiókodba érkezik, számla a TE NAV-azonosítód alatt megy.

A PromNET-webshop BYOK-modellt használ (Bring Your Own Key) — minden shop-tulajdonos a saját Stripe-fiókján keresztül fogadja a kifizetéseket. Ez azért van így, mert:

• A bevétel közvetlenül a Te EV / Kft / Bt számládra megy — nincs havi elszámolás, nincs köztes kéztulajdon
• A NAV-számlát is a Te neveden állítja ki a rendszer (az adótudást a saját NAV-technikai-fiókod adja — ld. NAV-bekötés súgó)
• A Stripe ATU (Acceptable Use) compliance teljesen a Tied — Te döntöd el milyen termékkört értékesítesz, és Te felelsz érte (PromNET nem korlátozza, viszont nem is kezesedik érte)

Mire lesz szükséged

• Stripe-fiók — ingyenes regisztráció a stripe.com-on
• EV / Kft / Bt adószám + bankszámlaszám — Stripe-fiók-ellenőrzéshez
• Live API-kulcsok — Stripe Dashboard → Developers → API keys
• Webhook signing secret — Stripe Dashboard → Developers → Webhooks

1. Stripe-fiók létrehozása

1. Menj a stripe.com-ra, kattints a “Start now” gombra
2. Add meg az email-címedet, jelszót, és válassz “Magyarország” régiót
3. Aktiváld a fiókot a Activate payments menüben:
   • Cégnév + adószám (EV: 12345678-1-23 formátum)
   • Telefonszám
   • Bankszámlaszám (28-jegyű GIRO vagy IBAN)
   • Tulajdonos azonosító (igazolvány-fotó + selfie)
4. A Stripe 2-3 munkanap alatt jóváhagyja (vagy kérhet kiegészítést)

Magyar EV-knek tipikusan minden megy első körre, ha:

• adószám = NAV-aktív
• bankszámla = ugyanazon EV-é
• a legutóbbi NAV-bevallásod le van adva

2. API-kulcsok kimásolása

A Stripe Dashboardon:

1. Developers → API keys
2. Két kulcs kell:
   • Publishable key — pk_live_... (UI-on jelenik meg, nem titok)
   • Secret key — sk_live_... ( TITOK, sose oszd meg senkivel)

TIPP: Először a test-mode kulcsokkal (pk_test_..., sk_test_...) próbálj rendelést leadni — ezekkel kártyaszám 4242 4242 4242 4242 minden dátummal/CVC-vel sikeres-payment-ot szimulál. Ha minden megy, válts live-ra.

3. Webhook signing secret

A PromNET kell hogy értesüljön ha egy fizetés bejön → ezt webhook-on kapja:

1. Stripe Dashboard → Developers → Webhooks → Add endpoint
2. Endpoint URL: https://promnet.hu/api/shop/<a-te-shop-slugod>/webhook/stripe (a <slugod> helyére a saját shop-slug-od kerül — pl. kati-szalon)
3. Events to send: csak ezek kellenek:
   • checkout.session.completed
   • payment_intent.succeeded
   • charge.refunded (opcionális, refund-eseményhez)
4. Kattints Add endpoint → most látsz egy “Signing secret” mezőt (whsec_...) — ezt másold ki

4. Bekötés a PromNET-webshopba

1. Menj az Admin → Shop → Beállítások → Stripe tab-ra
2. Töltsd ki a 3 mezőt:
   • Publishable key (pk_live_... vagy pk_test_...)
   • Secret key (sk_live_... vagy sk_test_...)
   • Webhook signing secret (whsec_...)
3. Kattints a “Kapcsolat tesztelése” gombra — a PromNET ping-eli a Stripe-API-dat. Sikeres = ✓ zöld badge, fiók-azonosítóddal együtt
4. Mentés — a kulcsok titkosítva tárolódnak (AES-GCM, a master-key csak a CF Pages secret-jeiben él, sosincs commit-olva)

5. Tiltott termékek — Te felelsz

A Stripe ATU a Te fiókodra vonatkozik. A főbb tiltott kategóriák:

• Felnőtt-tartalom (vibrátor, dildó, BDSM, eskorport-szolgáltatás)
• CBD / THC / kannabisz-termékek
• Fegyver / fegyver-tartozék / lőszer
• Szerencsejáték / online-kaszinó / lottó
• Hamisított / replica márka-áruk
• MLM / get-rich-quick séma
• Dohány / vape / nikotin-pouch (Magyarországon NDS-engedélyhez kötött)
• Gyógyszer / vény-köteles készítmények

Ha ilyet adnál el, a Stripe bezárhatja a fiókodat (chargeback-rendezés előtt) — a PromNET ezt nem tudja megakadályozni, mert a bevételi-flow közvetlenül a Tiéd. Olvasd el a Stripe ATU-t mielőtt aktiválod a shopot.

Hibakeresés

• “Connection refused”: rossz secret-key formátum (kell sk_test_ vagy sk_live_ prefix)
• “Webhook signature mismatch”: rossz whsec_... érték — másold újra a Stripe-ról
• “Account inactive”: a Stripe-fiókod még nem aktivált — fejezd be a Stripe-onboarding-ot (Activate payments)
• “Insufficient funds for refund”: a Stripe-egyenleged nem fedezi a refund-ot — átutalás manuálisan szükséges, vagy várj az auto-payouttal

Bármilyen kérdés / probléma → Privát ticket.