Download the PHP package netipar/simplepay without Composer
On this page you can find all versions of the php package netipar/simplepay. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package simplepay
SimplePay for Laravel
Modern Laravel package for SimplePay online payment integration. Start payments, handle IPN webhooks, manage card storage, process refunds, and more.
Based on the official SimplePay PHP SDK v2.1, rebuilt for Laravel with typed DTOs, Enums, Events, and full API coverage.
Quick Example
Requirements
- PHP 8.3+
- Laravel 12 or 13
- A SimplePay merchant account
Installation
Publish the config file:
Or publish the config file and the logo assets at once:
Add your merchant credentials to .env:
Usage
Obtaining the Services
Access all services through the SimplePay facade:
Start a Payment
Event-Specific Redirect URLs
SimplePay returns the customer to url after every outcome. Pass urls to use a separate page per outcome; SimplePay ignores url when urls is sent:
The order reference of a failed transaction can be sent again until the first successful payment; every start creates a new SimplePay transaction ID.
Two-Step Payment (Authorize + Finish)
Refund a Transaction
Query Transaction Status
Cancel a Transaction
Card Storage (OneClick Payments)
Recurring Payments
The start of a card registration (recurring in PaymentRequest) returns the recurring tokens in $response->tokens; they become active when the IPN reports the successful payment.
Apple Pay
Google Pay on Your Checkout Page
Google Pay is also available on the SimplePay payment page with PaymentMethod::CARD. To show the Google Pay button on your own checkout page, render it with googlePayConfig() and charge the token from your backend:
Set SIMPLEPAY_GOOGLE_PAY_MERCHANT_ID and SIMPLEPAY_GOOGLE_PAY_MERCHANT_NAME from the Google Pay & Wallet Console. The full flow with the JavaScript button is in the Google Pay example.
Auto Payment (Card Data on Your Page)
PCI-DSS certified merchants can send the card data themselves:
See 3DS browser data for building BrowserData.
EAM / Qvik Payment
Request to Pay (RTP)
Request to Pay back redirects can carry BackEvent::Pending: the customer gave the bank account number, but the transfer has not arrived yet. RtpStartRequest accepts urls with a pending URL as well.
IPN Webhook
The package automatically registers a POST /simplepay/ipn route with signature verification middleware. Listen to payment events in your application:
Available events (all receive IpnMessage DTO):
| Event | Trigger |
|---|---|
IpnReceived |
Every IPN notification |
PaymentSucceeded |
FINISHED status |
PaymentAuthorized |
AUTHORIZED (two-step) |
PaymentFailed |
NOTAUTHORIZED |
PaymentCancelled |
CANCELLED |
PaymentTimedOut |
TIMEOUT |
PaymentRefunded |
REFUND |
The IpnMessage DTO contains:
Back URL Handling
The package registers a GET /simplepay/back route. Customize the response by binding your own BackUrlResponse in AppServiceProvider:
Enums
Always use enum cases instead of raw strings:
Currency--HUF,EUR,USDPaymentMethod--CARD,WIRE,EAMPaymentStatus--INIT,FINISHED,AUTHORIZED,NOTAUTHORIZED,INPAYMENT,CANCELLED,TIMEOUT,INFRAUD,FRAUD,REFUND,REVERSEDBackEvent--SUCCESS,FAIL,CANCEL,TIMEOUT,PENDING(Request to Pay)TransactionType--CIT(Customer Initiated),MIT(Merchant Initiated),REC(Recurring)ErrorCode-- 350+ error codes with Hungarian descriptions
Error Handling
The package throws SimplePayApiException when the SimplePay API returns error codes:
When a card storage or auto payment requires a 3DS challenge, the API answers with error code 3004, and the response body holds the redirectUrl where the customer has to be sent:
Configuration
Key .env variables:
Multi-currency support -- each currency has its own merchant credentials:
Logos and Assets
The package includes the official SimplePay merchant logo pack. Publish the assets:
This copies logos and pre-composed variations to public/vendor/simplepay/.
Usage in Blade, Vue.js, or React:
Available logos: SimplePay (multiple sizes/orientations + white variants, and an SVG of the vertical logo), Visa, Mastercard, Maestro, Amex, Apple Pay, Google Pay, Qvik, OTP SZÉP. Pre-composed card type combinations are also included. See examples for Blade, Vue.js, and React checkout page examples.
Logging
Set SIMPLEPAY_LOG_CHANNEL to any Laravel log channel name. Example dedicated channel in config/logging.php:
Services Overview
| Service | Access | Purpose |
|---|---|---|
PaymentService |
SimplePay::payment() |
Standard payments, refunds, queries, Apple Pay, Google Pay, EAM |
CardStorageService |
SimplePay::cardStorage() |
OneClick, recurring, card/token management |
AutoPaymentService |
SimplePay::autoPayment() |
PCI-DSS direct card payments |
RtpService |
SimplePay::rtp() |
Request to Pay (bank transfers) |
SDK Compatibility
This package is built based on the SimplePay PHP SDK v2.1 (API v2). All API requests include the sdkVersion: SimplePay_PHP_SDK_2.1_Laravel identifier.
The merchant-side Google Pay flow follows the Payment PHP SDK 2.1.5 (2026-06-27) and the SimplePay Google Pay documentation (2026-09-01); the urls and pending handling follows the Request to Pay documentation (2026-08-17).
Examples
- English examples
- Magyar példák
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please review the contributing guide before opening a pull request.
Security Vulnerabilities
Please review the security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.
All versions of simplepay with dependencies
illuminate/http Version ^12.0||^13.0
illuminate/support Version ^12.0||^13.0