From a8b22d5b12484bdde6f3d03fbfccbed83b7d814e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tibor=20Heged=C5=B1s?= Date: Sun, 18 Oct 2026 10:52:40 +0200 Subject: [PATCH] Translate the code comments of the Hungarian examples to English - Code comments are English across the repository; the Hungarian example pages keep their Hungarian prose and sample data - Keep the two comments that show the actual Hungarian exception message - The log channel comment now says what null does: it disables logging (the Hungarian and English pages claimed the default channel is used) --- examples/en/configuration.md | 2 +- examples/hu/fizetes-inditas.md | 30 ++++++++--------- examples/hu/google-pay.md | 6 ++-- examples/hu/ipn-webhook.md | 16 ++++----- examples/hu/kartya-tarolas.md | 4 +-- examples/hu/konfiguracio.md | 50 ++++++++++++++-------------- examples/hu/lekerdezes-es-sztorno.md | 34 +++++++++---------- examples/hu/logok-es-asetek.md | 32 +++++++++--------- examples/hu/rtp.md | 8 ++--- examples/hu/visszaterites.md | 8 ++--- 10 files changed, 95 insertions(+), 95 deletions(-) diff --git a/examples/en/configuration.md b/examples/en/configuration.md index 1564f35..946493f 100644 --- a/examples/en/configuration.md +++ b/examples/en/configuration.md @@ -106,7 +106,7 @@ return [ |-------------------------------------------------------------------------- | | The log channel used for SimplePay-related logging. - | Set to null to use the default log channel. + | Set it to null to disable logging. | */ 'log_channel' => env('SIMPLEPAY_LOG_CHANNEL'), diff --git a/examples/hu/fizetes-inditas.md b/examples/hu/fizetes-inditas.md index 2d69be6..f52fdcc 100644 --- a/examples/hu/fizetes-inditas.md +++ b/examples/hu/fizetes-inditas.md @@ -33,7 +33,7 @@ $response = SimplePay::payment()->start(new PaymentRequest( ], )); -// Átirányítás a fizetési oldalra +// Redirect the customer to the payment page return redirect($response->paymentUrl); ``` @@ -42,9 +42,9 @@ return redirect($response->paymentUrl); A `start()` metódus által visszaadott válasz a következő adatokat tartalmazza: ```php -$response->transactionId; // SimplePay tranzakció azonosító (int) -$response->paymentUrl; // Fizetési oldal URL, ahova a vásárlót át kell irányítani -$response->timeout; // A fizetés indításának határideje (Request to Pay indításnál null) +$response->transactionId; // SimplePay transaction ID (int) +$response->paymentUrl; // Payment page URL to redirect the customer to +$response->timeout; // Deadline for starting the payment (null for Request to Pay starts) ``` ## Kétlépcsős fizetés (preautorizáció) @@ -131,7 +131,7 @@ $response = SimplePay::payment()->start(new PaymentRequest( url: route('simplepay.back'), methods: [PaymentMethod::CARD], - // Számlázási cím (kötelező) + // Billing address (required) invoice: new Address( name: 'Teszt Felhasználó', country: 'hu', @@ -140,7 +140,7 @@ $response = SimplePay::payment()->start(new PaymentRequest( address: 'Teszt utca 1.', ), - // Szállítási cím (opcionális) + // Delivery address (optional) delivery: new Address( name: 'Teszt Felhasználó', country: 'hu', @@ -149,16 +149,16 @@ $response = SimplePay::payment()->start(new PaymentRequest( address: 'Szállítás utca 5.', ), - // Vásárló adatai (opcionális) + // Customer name (optional) customer: 'Teszt Felhasználó', - // Szállítási költség (opcionális) + // Shipping cost (optional) shippingPrice: 1500, - // Kedvezmény (opcionális) + // Discount (optional) discount: 500, - // Tételek + // Items items: [ new Item(title: 'Laptop táska', price: 8500, quantity: 1), new Item(title: 'Egérpárna', price: 3000, quantity: 1), @@ -202,8 +202,8 @@ A `methods` tömbben megadható értékek: ```php use Netipar\SimplePay\Enums\PaymentMethod; -PaymentMethod::CARD // Bankkártyával -PaymentMethod::WIRE // Átutalással +PaymentMethod::CARD // Bank card +PaymentMethod::WIRE // Bank transfer ``` ## Pénznemek @@ -211,7 +211,7 @@ PaymentMethod::WIRE // Átutalással ```php use Netipar\SimplePay\Enums\Currency; -Currency::HUF // Magyar forint -Currency::EUR // Euró -Currency::USD // Amerikai dollár +Currency::HUF // Hungarian forint +Currency::EUR // Euro +Currency::USD // US dollar ``` diff --git a/examples/hu/google-pay.md b/examples/hu/google-pay.md index b520839..d21195c 100644 --- a/examples/hu/google-pay.md +++ b/examples/hu/google-pay.md @@ -131,7 +131,7 @@ Egy minimális Blade-oldal a hivatalos minta alapján: type: simplePayTransaction.paymentType, parameters: { allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'], - // Az 'AMEX' akkor kerüljön ide, ha a SimplePay-szerződésed elfogadja az American Expresst. + // Add 'AMEX' if your SimplePay contract accepts American Express. allowedCardNetworks: ['MASTERCARD', 'VISA'], }, tokenizationSpecification: { @@ -193,13 +193,13 @@ Egy minimális Blade-oldal a hivatalos minta alapján: const result = await response.json(); if (result.redirectUrl) { - // 3DS challenge: utána a SimplePay a kérés url címére irányítja vissza a vásárlót. + // 3DS challenge: SimplePay returns the customer to the request's url afterwards. window.location.replace(result.redirectUrl); return; } - // Nincs 3DS challenge: az eredményt itt jelenítsd meg, a rendelést az IPN alapján teljesítsd. + // No 3DS challenge: show the result here; the order is fulfilled from the IPN. } diff --git a/examples/hu/ipn-webhook.md b/examples/hu/ipn-webhook.md index 6fdb18e..02ff5fb 100644 --- a/examples/hu/ipn-webhook.md +++ b/examples/hu/ipn-webhook.md @@ -121,14 +121,14 @@ Minden event tartalmaz egy `$event->ipn` objektumot az alábbi tulajdonságokkal ```php $ipn = $event->ipn; -$ipn->orderRef; // Megrendelési hivatkozás (string) -$ipn->transactionId; // SimplePay tranzakció azonosító (int) -$ipn->status; // Tranzakció státusza (PaymentStatus) -$ipn->currency; // Pénznem (Currency) -$ipn->total; // Tranzakció összege (float) -$ipn->finishDate; // Tranzakció befejezésének dátuma (string) -$ipn->paymentMethod; // Fizetési módszer (string, pl. "CARD") -$ipn->cardMask; // Maszkolt kártyaszám (string|null, pl. "1234-xxxx-xxxx-5678") +$ipn->orderRef; // Order reference (string) +$ipn->transactionId; // SimplePay transaction ID (int) +$ipn->status; // Transaction status (PaymentStatus) +$ipn->currency; // Currency (Currency) +$ipn->total; // Transaction total (float) +$ipn->finishDate; // Date the transaction finished (string) +$ipn->paymentMethod; // Payment method (string, e.g. "CARD") +$ipn->cardMask; // Masked card number (string|null, e.g. "1234-xxxx-xxxx-5678") ``` ## Használat az IpnReceived általános event-tel diff --git a/examples/hu/kartya-tarolas.md b/examples/hu/kartya-tarolas.md index c04da72..0360173 100644 --- a/examples/hu/kartya-tarolas.md +++ b/examples/hu/kartya-tarolas.md @@ -53,10 +53,10 @@ $result = SimplePay::cardStorage()->doRecurring(new RecurringRequest( Tárolt kártya adatainak lekérdezése: ```php -// Alap kártya lekérdezés +// Basic card query $card = SimplePay::cardStorage()->cardQuery(Currency::HUF, 'card-abc-123'); -// Kártya lekérdezés előzményekkel (tranzakció történelem) +// Card query with history (past transactions) $cardWithHistory = SimplePay::cardStorage()->cardQuery( Currency::HUF, 'card-abc-123', diff --git a/examples/hu/konfiguracio.md b/examples/hu/konfiguracio.md index 35dda24..e7da846 100644 --- a/examples/hu/konfiguracio.md +++ b/examples/hu/konfiguracio.md @@ -33,22 +33,22 @@ return [ /* |-------------------------------------------------------------------------- - | Sandbox mód + | Sandbox Mode |-------------------------------------------------------------------------- | - | Sandbox módban a SimplePay teszt környezetet használja. - | Éles üzemben állítsd false-ra. + | In sandbox mode the SimplePay test environment is used. + | Set it to false in production. | */ 'sandbox' => env('SIMPLEPAY_SANDBOX', true), /* |-------------------------------------------------------------------------- - | Kereskedői fiókok pénznemenként + | Merchant Accounts per Currency |-------------------------------------------------------------------------- | - | Minden pénznemhez külön merchant ID és secret key tartozik. - | Csak azokat a pénznemeket kell megadni, amelyeket használsz. + | Each currency has its own merchant ID and secret key. + | Only configure the currencies you use. | */ 'merchants' => [ @@ -68,11 +68,11 @@ return [ /* |-------------------------------------------------------------------------- - | API URL-ek + | API URLs |-------------------------------------------------------------------------- | - | A SimplePay sandbox és éles API URL-jei. - | Általában nem kell módosítani. + | The sandbox and live API URLs of SimplePay. + | Usually there is no need to change them. | */ 'urls' => [ @@ -85,30 +85,30 @@ return [ | Back URL |-------------------------------------------------------------------------- | - | Az alapértelmezett visszatérítési URL, ahova a vásárló érkezik - | a fizetés befejezése után. Felülírhatod a PaymentRequest-ben. + | The default back URL where the customer arrives after the + | payment. You can override it in the PaymentRequest. | */ 'back_url' => env('SIMPLEPAY_BACK_URL'), /* |-------------------------------------------------------------------------- - | Log csatorna + | Log Channel |-------------------------------------------------------------------------- | - | A SimplePay kommunikáció logolásához használt csatorna. - | Ha null, a default log csatornát használja. + | The log channel of the SimplePay communication. + | Set it to null to disable logging. | */ 'log_channel' => env('SIMPLEPAY_LOG_CHANNEL'), /* |-------------------------------------------------------------------------- - | Időtúllépés (timeout) + | Timeout |-------------------------------------------------------------------------- | - | A fizetési ablak időtúllépése másodpercben. - | Az alapérték 600 másodperc (10 perc). + | The payment window timeout in seconds. + | The default is 600 seconds (10 minutes). | */ 'timeout' => env('SIMPLEPAY_TIMEOUT', 600), @@ -118,8 +118,8 @@ return [ | Google Pay |-------------------------------------------------------------------------- | - | A Google Pay kereskedői azonosító és név a saját fizetési oldalon - | megjelenő Google Pay gombhoz. + | The Google Pay merchant ID and name for the Google Pay button on your + | own checkout page. | */ 'google_pay' => [ @@ -129,10 +129,10 @@ return [ /* |-------------------------------------------------------------------------- - | Auto challenge (3DS) + | Auto Challenge (3DS) |-------------------------------------------------------------------------- | - | Automatikus 3D Secure challenge kérés. + | Automatic 3D Secure challenge request. | */ 'auto_challenge' => env('SIMPLEPAY_AUTO_CHALLENGE', true), @@ -145,11 +145,11 @@ return [ A SimplePay rendszerben minden pénznemhez külön kereskedői fiók tartozik. Csak azokat kell beállítanod, amelyeket használni kívánod: ```env -# Ha csak HUF-ban fogadsz fizetéseket: +# If you only accept HUF payments: SIMPLEPAY_HUF_MERCHANT=your_huf_merchant_id SIMPLEPAY_HUF_SECRET_KEY=your_huf_secret_key -# Ha EUR-ban is fogadsz: +# If you also accept EUR: SIMPLEPAY_EUR_MERCHANT=your_eur_merchant_id SIMPLEPAY_EUR_SECRET_KEY=your_eur_secret_key ``` @@ -177,7 +177,7 @@ Ha külön log fájlba szeretnéd gyűjteni a SimplePay kommunikációt, hozz l ```php // config/logging.php 'channels' => [ - // ...meglévő csatornák... + // ...existing channels... 'simplepay' => [ 'driver' => 'daily', @@ -201,7 +201,7 @@ SIMPLEPAY_LOG_CHANNEL=simplepay Az alapértelmezett időtúllépés 600 másodperc (10 perc). Ha módosítani szeretnéd: ```env -SIMPLEPAY_TIMEOUT=900 # 15 perc +SIMPLEPAY_TIMEOUT=900 # 15 minutes ``` Ez azt jelenti, hogy a vásárlónak ennyi ideje van befejezni a fizetést a SimplePay oldalán. diff --git a/examples/hu/lekerdezes-es-sztorno.md b/examples/hu/lekerdezes-es-sztorno.md index ab023fd..74c963b 100644 --- a/examples/hu/lekerdezes-es-sztorno.md +++ b/examples/hu/lekerdezes-es-sztorno.md @@ -13,13 +13,13 @@ $query = SimplePay::payment()->query( transactionId: 123456, ); -$query->status; // Tranzakció státusza (PaymentStatus) -$query->total; // Tranzakció összege (float) -$query->orderRef; // Megrendelési hivatkozás (string) -$query->remainingTotal; // Hátralévő összeg visszatérítés után (?float) -$query->paymentDate; // Fizetés dátuma (?string) -$query->finishDate; // Lezárás dátuma (?string) -$query->method; // Fizetési mód, pl. "CARD" (?string) +$query->status; // Transaction status (PaymentStatus) +$query->total; // Transaction total (float) +$query->orderRef; // Order reference (string) +$query->remainingTotal; // Remaining amount after refunds (?float) +$query->paymentDate; // Payment date (?string) +$query->finishDate; // Finish date (?string) +$query->method; // Payment method, e.g. "CARD" (?string) ``` ## Visszatérítés (refund) @@ -35,10 +35,10 @@ $refund = SimplePay::payment()->refund(new RefundRequest( currency: Currency::HUF, transactionId: 123456, orderRef: 'ORDER-123', - amount: 2500, // A teljes összeg + amount: 2500, // The full amount )); -$refund->remainingTotal; // 0 (minden visszatérítve) +$refund->remainingTotal; // 0 (everything refunded) ``` ### Részleges visszatérítés @@ -48,10 +48,10 @@ $refund = SimplePay::payment()->refund(new RefundRequest( currency: Currency::HUF, transactionId: 123456, orderRef: 'ORDER-123', - amount: 1000, // Csak 1000 Ft visszatérítése + amount: 1000, // Refund only HUF 1,000 )); -$refund->remainingTotal; // 1500 (a fennmaradó összeg) +$refund->remainingTotal; // 1500 (the remaining amount) ``` ### Többszörös részleges visszatérítés @@ -59,7 +59,7 @@ $refund->remainingTotal; // 1500 (a fennmaradó összeg) Lehetséges többször is részlegesen visszatéríteni, amíg a teljes összeg el nem fogy: ```php -// Első részleges visszatérítés +// First partial refund $refund1 = SimplePay::payment()->refund(new RefundRequest( currency: Currency::HUF, transactionId: 123456, @@ -68,7 +68,7 @@ $refund1 = SimplePay::payment()->refund(new RefundRequest( )); // $refund1->remainingTotal => 2000 -// Második részleges visszatérítés +// Second partial refund $refund2 = SimplePay::payment()->refund(new RefundRequest( currency: Currency::HUF, transactionId: 123456, @@ -100,16 +100,16 @@ $finish = SimplePay::payment()->finish(new FinishRequest( currency: Currency::HUF, transactionId: 123456, orderRef: 'ORDER-PREAUTH-001', - amount: 15000, // a terhelendő összeg - originalTotal: 15000, // a zárolt összeg + amount: 15000, // the amount to capture + originalTotal: 15000, // the authorized amount )); ``` A `finish()` meghívásakor az összeg lehet kisebb is, mint az eredetileg zárolt összeg (részleges terhelés). ```php -// Eredetileg 15000 Ft zárolt -// Csak 12000 Ft terhelése +// HUF 15,000 was authorized +// Capture only HUF 12,000 $finish = SimplePay::payment()->finish(new FinishRequest( currency: Currency::HUF, transactionId: 123456, diff --git a/examples/hu/logok-es-asetek.md b/examples/hu/logok-es-asetek.md index b8ec0e7..c9325a8 100644 --- a/examples/hu/logok-es-asetek.md +++ b/examples/hu/logok-es-asetek.md @@ -14,19 +14,19 @@ Ez a `public/vendor/simplepay/` könyvtárba másolja az összes logót és vari ``` public/vendor/simplepay/ -├── logos/ # Egyedi logók -│ ├── simplepay_200x50.png # SimplePay fő logó (200x50) -│ ├── simplepay_w140.png # SimplePay 140px széles -│ ├── simplepay_w240.png # SimplePay 240px széles -│ ├── simplepay_w360.png # SimplePay 360px széles -│ ├── simplepay_horizontal_01.png # Fekvő logó v1 -│ ├── simplepay_horizontal_02.png # Fekvő logó v2 -│ ├── simplepay_vertical.png # Álló logó -│ ├── simplepay_vertical.svg # Álló logó (SVG) -│ ├── simplepay_top.png # Felül elhelyezett logó -│ ├── simplepay_*-white.png # Fehér változatok (sötét háttérhez) -│ ├── visa_logo_color.png # Visa (színes) -│ ├── visa_logo_bw.png # Visa (fekete-fehér) +├── logos/ # Individual logos +│ ├── simplepay_200x50.png # SimplePay main logo (200x50) +│ ├── simplepay_w140.png # SimplePay 140px wide +│ ├── simplepay_w240.png # SimplePay 240px wide +│ ├── simplepay_w360.png # SimplePay 360px wide +│ ├── simplepay_horizontal_01.png # Horizontal logo v1 +│ ├── simplepay_horizontal_02.png # Horizontal logo v2 +│ ├── simplepay_vertical.png # Vertical logo +│ ├── simplepay_vertical.svg # Vertical logo (SVG) +│ ├── simplepay_top.png # Top-placed logo +│ ├── simplepay_*-white.png # White variants (for dark backgrounds) +│ ├── visa_logo_color.png # Visa (color) +│ ├── visa_logo_bw.png # Visa (black & white) │ ├── mastercard_logo_color_new.png │ ├── mastercard_logo_bw_new.png │ ├── maestro_logo_color_new.png @@ -37,7 +37,7 @@ public/vendor/simplepay/ │ ├── GPay_logo_color_new.png │ ├── qvik_logo_color.png │ └── OTPszepkartya_logo_color.png -└── variaciok/ # Előre összeállított logó kombinációk +└── variaciok/ # Pre-composed logo combinations ├── SimplePay_Logo+MC-Maestro-Visa/ ├── SimplePay_Logo+Qvik/ ├── SimplePay_Logo+SZEP/ @@ -103,14 +103,14 @@ public/vendor/simplepay/ Ha nem szeretnéd egyenként kezelni a kártyalogókat, használd az előre összeállított variációkat: ```blade -{{-- SimplePay + bankkártyák (Amex nélkül) --}} +{{-- SimplePay + bank cards (without Amex) --}} SimplePay - Bankkártyás fizetés -{{-- SimplePay + bankkártyák (Amex-szel) --}} +{{-- SimplePay + bank cards (with Amex) --}} SimplePay - Bankkártyás fizetésstart(new RtpStartRequest( customer: 'Teszt Vásárló', )); -// Válasz adatok -$response->paymentUrl; // URL a fizetési oldalhoz -$response->transactionId; // SimplePay tranzakció azonosító -$response->timeout; // null: az RTP indítás válaszában nincs timeout +// Response data +$response->paymentUrl; // Payment page URL +$response->transactionId; // SimplePay transaction ID +$response->timeout; // null: RTP start responses have no timeout ``` ### Eseményenkénti visszairányítási címek diff --git a/examples/hu/visszaterites.md b/examples/hu/visszaterites.md index d36e05a..dc2140b 100644 --- a/examples/hu/visszaterites.md +++ b/examples/hu/visszaterites.md @@ -68,10 +68,10 @@ A `BackResponse` objektum az alábbi tulajdonságokat tartalmazza: ```php $back->event; // BackEvent enum (Success, Fail, Cancel, Timeout, Pending) -$back->transactionId; // SimplePay tranzakció azonosító (int) -$back->orderRef; // Az eredeti megrendelési hivatkozás (string) -$back->merchant; // Kereskedői azonosító (string) -$back->total; // A fizetés összege (float) +$back->transactionId; // SimplePay transaction ID (int) +$back->orderRef; // The original order reference (string) +$back->merchant; // Merchant ID (string) +$back->total; // Payment total (float) ``` ## Események részletesen