Online fizetési szolgáltatók¶

A HellaBooking két online fizetési átjárót támogat az ügyfelek bankkártyás fizetéseinek feldolgozásához.

Támogatott szolgáltatók¶

ID	Szolgáltató	Piac	Integrációs projekt
1	SimplePay	Magyarország	`SimplePay/`
2	Stripe	Nemzetközi	`Stripe/`

Szolgáltató konfiguráció¶

A szolgáltatók a PaymentProvider táblában kerülnek konfigurálásra az alábbi mezőkkel:

Mező	Leírás
Name	Megjelenítési név
Merchant	Kereskedő azonosító
SecretKey	API titkos kulcs
RemoteURL	Átjáró végpont URL
OperatorName	Üzemeltető hivatalos neve
OperatorAddress	Üzemeltető hivatalos címe

Demo környezet

A demo rendszerben 1 fizetési szolgáltató van konfigurálva.

Szolgáltatók összekapcsolása szolgáltatásokkal¶

Minden ServiceType legfeljebb két szolgáltatóra hivatkozhat a PaymentProvider_ID (elsődleges) és PaymentProvider2_ID (másodlagos) mezőkön keresztül.

SimplePay integráció¶

A SimplePay egy magyar fizetési átjáró, amely bankkártyákat és SZÉP kártyát (Széchenyi Pihenőkártya) támogat.

Fő jellemzők:

IPN (Instant Payment Notification) visszahívásokat használ az aszinkron státuszfrissítésekhez.
Az Order tábla követi az egyes tranzakciókat:

Mező	Leírás
OrderReference	Egyedi rendelésazonosító
SimplePayStatus	Aktuális tranzakciós státusz
SimplePayReference	SimplePay referencia azonosító
TransactionResult	A tranzakció eredménye

Az ügyfelek a User tábla SimplePayAcceptance jelzőjével járulnak hozzá.

Ismétlődő kártyás fizetések¶

Előfizetések esetén a rendszer tárolja a kártyaadatokat az ismétlődő terhelésekhez:

SimplePayReference -- token az ismétlődő terhelésekhez
CardExpiry -- kártya lejárati dátum az érvényesítéshez

Stripe integráció¶

A Stripe egy nemzetközi fizetési átjáró, amelyet a nem magyarországi piacokra használnak.

Eseménykövetés a StripeEventEnum segítségével:

ID	Esemény
1	Sikeres
2	Sikertelen
3	Megszakítva
4	Időtúllépés

Osztott fizetés¶

Az osztott fizetés lehetővé teszi, hogy több ügyfél megossza egy foglalás költségét.

flowchart LR
    A[Foglalás létrehozva] --> B{Osztott fizetési mód?}
    B -->|KI| C[Egyetlen fizető]
    B -->|OPCIONÁLIS| D[Ügyfél választ]
    B -->|KÖTELEZŐ| E[Minden résztvevő fizeti a részét]
    D --> F[Fizetési linkek kiküldve]
    E --> F
    F --> G{Mindenki fizetett 24 órán belül?}
    G -->|Igen| H[Foglalás megerősítve]
    G -->|Nem| I[Foglalás lejárt]

Beállítás	Szint	Érték
SplitPaymentEnabled	Sportpálya típusonként (`SportsFieldType_Enum`)	OFF / OPTIONAL / MANDATORY
SplitPaymentEnabled	Globális (`SystemParameter`)	NO (alapértelmezett)
SplitPaymentExpiration	Globális (`SystemParameter`)	24 óra

Warning

A globális SplitPaymentEnabled paramétert YES értékre kell állítani, mielőtt a pálya típusonkénti beállítás érvénybe lépne. A 24 órás lejárati ablak azt jelenti, hogy a ki nem fizetett osztott részek a foglalás érvénytelenné válását okozzák.