Skip to content

Translate the code comments of the Hungarian examples to English #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hegedustibor merged 1 commit into from
Oct 18, 2026
Merged

Translate the code comments of the Hungarian examples to English #6

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion examples/en/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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'),
Expand Down
30 changes: 15 additions & 15 deletions examples/hu/fizetes-inditas.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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);
```

Expand All @@ -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ó)
Expand Down Expand Up @@ -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',
Expand All @@ -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',
Expand All @@ -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),
Expand Down Expand Up @@ -202,16 +202,16 @@ 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

```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
```
6 changes: 3 additions & 3 deletions examples/hu/google-pay.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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: {
Expand Down Expand Up @@ -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.
}
</script>
<script async src="https://pay.google.com/gp/p/js/pay.js" onload="onGooglePayLoaded()"></script>
Expand Down
16 changes: 8 additions & 8 deletions examples/hu/ipn-webhook.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions examples/hu/kartya-tarolas.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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',
Expand Down
50 changes: 25 additions & 25 deletions examples/hu/konfiguracio.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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' => [
Expand All @@ -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' => [
Expand All @@ -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),
Expand All @@ -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' => [
Expand All @@ -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),
Expand All @@ -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
```
Expand Down Expand Up @@ -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',
Expand All @@ -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.
Expand Down
34 changes: 17 additions & 17 deletions examples/hu/lekerdezes-es-sztorno.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -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
Expand All @@ -48,18 +48,18 @@ $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

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,
Expand All @@ -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,
Expand Down Expand Up @@ -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,
Expand Down
Loading
Loading