SimplePay for Laravel
Bankkártyás, Apple Pay- és Google Pay-fizetés, kártyamentés, ismétlődő terhelés és visszatérítés Laravel-alkalmazásban. A SimplePay hivatalos PHP SDK-jára (v2.1) építettük, Laravel-módra: típusos adatobjektumokkal, enumokkal és eseményekkel.
$ composer require netipar/simplepay
use Netipar\SimplePay\Facades\SimplePay;
use Netipar\SimplePay\Dto\PaymentRequest;
use Netipar\SimplePay\Enums\Currency;
use Netipar\SimplePay\Enums\PaymentMethod;
$response = SimplePay::payment()->start(new PaymentRequest(
currency: Currency::HUF,
total: 25400,
orderRef: 'ORDER-2026-001',
customerEmail: 'customer@example.com',
language: 'HU',
url: route('simplepay.back'),
methods: [PaymentMethod::CARD],
invoice: $billingAddress,
));
return redirect($response->paymentUrl);- Legújabb verzió
- v2.1.0
- 2026. október 18.
- Követelmények
- PHP 8.3+
- Laravel 12 és 13
- Licenc
- MIT
- üzleti célra is szabadon
- Letöltések
- 283
- Packagist, összesen
Mire jó?
A teljes SimplePay API, Laravelben megszokott módon
A fizetés indításától a visszatérítésig minden SimplePay-funkció elérhető, nyers tömbök és kézi aláírás nélkül.
-
Fizetés néhány sorból
Típusos kéréssel indítod a fizetést, a vásárló a SimplePay fizetőoldalára kerül. Kétlépcsős fizetés (zárolás, majd terhelés) is választható.
Így működik:
SimplePay::payment()->start() -
Megbízható visszaigazolás
A csomag regisztrálja az IPN-végpontot és ellenőrzi az aláírást. A fizetés kimeneteléről Laravel-eseményt kapsz, erre köthető a számla vagy az értesítő.
Így működik:
PaymentSucceeded -
Előfizetés és egykattintásos fizetés
Mentett kártyával a vásárló adatmegadás nélkül fizet, tokennel pedig ismétlődő terhelés indítható, például előfizetéshez vagy tagdíjhoz.
Így működik:
cardStorage()->doRecurring() -
Visszatérítés és lekérdezés
Teljes vagy részleges visszatérítés, tranzakció-lekérdezés és sztornó, ugyanazon a felületen, mint a fizetés.
Így működik:
payment()->refund() -
Apple Pay, Google Pay, Qvik és Request to Pay
Az Apple Pay, a saját fizetőoldalon futó Google Pay, a Qvik (EAM) és a banki átutalásos Request to Pay is ugyanabból a csomagból érhető el.
Így működik:
payment()->doGooglePay() -
Érthető hibák, több pénznem
350+ hibakód magyar leírással, és pénznemenként (HUF, EUR, USD) saját kereskedői fiók.
Így működik:
SimplePayApiException
Négy szolgáltatás, egy facade:
SimplePay::payment()
SimplePay::cardStorage()
SimplePay::autoPayment()
SimplePay::rtp()
Így működik
A fizetés útja a rendeléstől a visszaigazolásig
-
1
Fizetés indítása
A rendelésből típusos kérés lesz, a vásárló a SimplePay oldalára kerül.
PaymentRequest -
2
Fizetés a SimplePay-nél
Kártyával, Apple Pay-jel vagy Qvikkel, a SimplePay fizetőoldalán.
$response->paymentUrl -
3
IPN-értesítés
A csomag ellenőrzi az aláírást, és aláírt választ küld vissza.
POST /simplepay/ipn -
4
Laravel-esemény
Sikeres, sikertelen, megszakított, lejárt és visszatérített fizetésre külön esemény.
PaymentSucceeded -
5
A te folyamatod
Rendelés lezárása, értesítő, számla, például a Számlázz.hu-csomaggal.
Számlázz.hu for Laravel
Visszatéréskor a GET /simplepay/back útvonal a saját BackUrlResponse osztályodra bízza, hova kerüljön a vásárló sikeres, sikertelen, megszakított vagy lejárt fizetés után, Request to Pay-nél pedig a még folyamatban lévő utalásnál is.
Kódpéldák
Néhány sor, és működik
use Illuminate\Support\Facades\Event;
use Netipar\SimplePay\Events\PaymentSucceeded;
// The package registers POST /simplepay/ipn and verifies the signature.
Event::listen(function (PaymentSucceeded $event): void {
$ipn = $event->ipn;
Order::firstWhere('reference', $ipn->orderRef)
?->markAsPaid($ipn->transactionId);
});Minőség
Tesztelve, verziózva, dokumentálva
Kompatibilitás
Minden változtatás után mind a hat párosításon lefut a tesztcsomag (GitHub Actions).
| PHP | Laravel 12 | Laravel 13 |
|---|---|---|
| 8.3 | ||
| 8.4 | ||
| 8.5 |
Amire számíthatsz
- 106 automatizált teszt (Pest)
- A hivatalos SimplePay PHP SDK v2.1 alapján
- Laravel Boost skill az AI-kódasszisztensnek
- Angol és magyar példák a tárolóban
- Hivatalos SimplePay-logócsomag a fizetési oldalhoz
- MIT-licenc: üzleti projektben is szabadon használható
Verziótörténet
Teljes CHANGELOG (új lapon nyílik)-
v2.1.0
A kérések a hivatalos SDK mezőivel mennek: javítva az ismétlődő (tokenes) és az egykattintásos fizetés, a Request to Pay, az Apple Pay és a qvik; a napló nem tartalmaz kártyaadatot.
-
v2.0.0
Laravel 13-támogatás, PHP 8.3 minimum, Google Pay a saját fizetőoldalon és eseményenkénti visszatérési URL-ek.
-
v1.2.0
A SimplePay v2-es IPN-üzenetei pénznem és összeg nélkül is feldolgozhatók.
-
v1.1.0
Az IPN-aláírás ellenőrzése pénznem nélkül, a kereskedői azonosító alapján.
-
v1.0.2
Laravel Boost skill az AI-támogatott integrációhoz.
Az első kiadás 2026. március 2-án jelent meg a hivatalos SimplePay PHP SDK v2.1 alapján, eddig összesen 7 kiadás készült.
Élesben
DermaSoul
A pszichodermatológiai támogató program témaköreit SimplePay-jel lehet megvásárolni, és sikeres fizetés után automatikusan elkészül a Számlázz.hu-számla.
A DermaSoul-referencia</Fizetés>
SimplePay-fizetés kellene, de nincs rá kapacitásotok?
A fizetési folyamatot is megépítjük: fizetés, visszaigazolás, számlázás és értesítések, a ti rendszeretekbe.
Beszéljünk a projektedrőlNem szükséges kész specifikáció. Elég, ha leírod, mit szeretnétek megoldani.
Ügyfeleink mondták rólunk
Büszkék vagyunk arra, hogy ügyfeleink hosszú távon is elégedettek a közös munkával. Íme néhány visszajelzés, ami igazán számít.
5,0 átlag az 5-ből, 8 Google-értékelés- Megbízható partner Valódi eredmények, hosszú távú együttműködések
- Szakértő csapat Komplex projektek, átlátható folyamatok
- Ügyfélközpontú szemlélet Mindig a közös célokra fókuszálunk
Az alábbi vélemények ügyfeleinktől származó, valós visszajelzések. Ez csak egy kis ízelítő, a teljes listát Google-értékeléseinknél találod.
